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DISCLAIMER 


This manual represents an attempt to docusent the "current" state of the 
Michigan Terminal Systea (MTS) as used at Wayne State University. It is a 
revision of MIS the coupating Center (Volume 1, January 1973) published 
by the et of Michigan Coraputing Center at Ann Arbor and MIS -= 
Syatem (Volusae 1, April 1971) published by the Wayne State University 
Computing and Data Processing Center. 


As the system is developed, some sections of this manual will beconse 
obsolete. The user should refer to the file HRLP:NEBWS and the WSU CDPC 
newsletter "Overflow" for the latest information about nodifications to MTS. 
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The software developed by the University of Michigan Coaputing Center for 
the operation of the 360/67 dual=-processor computer can be described as a 
multi-processor supervisor which handles a number of resident, re-entrant 
programs. Among these is a large subsystem, called MTS (Michigan Terminal 
Systen), for command interpretation, execution control, file handling and. 
accounting maintenance. The majority of users interact with the computer's 
resources by means of the latter operating subsysten. The various MTS 
manuals are concerned principally with describing the use of this subsysten. 


This, the Third Edition of the MTS manual, is a major revision and 
reorganization of the Second Edition (December 1, 1967). The third edition 
will consist of a series of 10 or more separate, self-contained volumes, to 
be published over a period of many months. Eight volumes in the third 
edition have already appeared. 


Public File Descriptions, Volume 2, revised April 1971 

Terminals and Tapes, Volume 4, September 1972 

System Services, Volume 5, December 1971 

SNOBOL4S, Volume 9, March 1969 (currently out of print) 

BASIC in MTS, Volume 10, August 1971 

Plot Description Systen, Volume 11, April 1971 

Others | are in preparation. The numerical order of the volumes is not 
necessarily the chronological order; for example, Volumes 2, 3, and 9 
appeared before Volume 1. However, in general, the higher the number, the 
more specialized the volume is. Volume 1, for example, introduces the user 
to MTS and the Computing Center, while Volume 10 deals exclusively with 
BASIC. The attempt to make each volume mostly self-contained naturally 
results in a certain amount of repetition. Such things as public file 
descriptions, for example, may appear in more than one volume. However, 
with this arrangement, the user is not forced to buy the entire set of 
Manuals, but only those that serve his immediate needs. And, hopefully, 
each volume will be smaller and of a more manageable size than before. 


Lynn R. Leader 

Richard A. Salisbury 

Mary Ann Wilkes 
General Editors 
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4SU_PREPACE TO_VOLUSE_1 


The April 1974 revision of Volume 1 reflects the changes that have been 
made to MTS at WSU since the first printing of Volume 1 in April 1971. It 
also incorporates relevant parts of HTS AND THE COMPUTING CENTER (Volume 1) 
published by the University Michigan in January 1973. The changes sade 
include deletion of material specific to the University of Michigan, 
alterations necessary to reflect the differences between the two systens, 
and additions to reflect the current development at WSU. — 


We are extremely grateful to the University of Michigan Computing Center 
for peraission to publish this revision of their manual. The following 
paragraph is quoted froa their preface to Volume 1 of February 1971: 


"While we would like to acknowledge the contributions of many people to 
this volume, it is the sad truth that at this point the editors (and others) 
have rewritten and restructured each others writeups and other people's 
writeups over and over to the extent that it is impossible to assign the 
exclusive blame for any part of this manual to anybody." 


We would also like to acknowledge that much of the raw fodder for this 
manual also care from the University of Alberta Computing Center and the 
University of British Colusabia Computing Center. It is difficult at this 
time to even identify from which sources parts of this manual came. More 
people have contributed to this manual then could possibly be identified; to 
each we are grateful. 


The writeups in this volume refer occasionally to other volumes that have 
not been published. While this is regrettable, we felt that it would be 
better to include the reference in the hope that the the volume would be 
published before the next printing. 


The last page of this manual is an Update Request Form which aust be 
returned to the WSU Documentation Librarian to insure that future updates 
are received. It can also be used for suggestions or corrections. 


This publication obsoletes WSU Technical Memos 1 and 12 (TM001=000 and 
TM012=000). 


Richard L. Wiersma 

Russell @. Pratt 

Barbara B. Wolfe 
Revision Editors 
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Information on computer utilization at WSU is obtained primarily fror 
documentation. The documentation sources may be many: WSU Computing and 
Data Processing Center (CDPC) publications, 0 of M Computing Center 
publications, IBM, and manuals and texts from other sources. This chapter 
describes the publications necessary for utilization of the operating system 
MTS (Michigan Terminal Systera) at WSU and references other documents for 
some of the more commonly used computer applications. 


The Academic Services Department of the Computing and Data Processing 
Center attempts to compile and disseminate complete, accurate, detailed, and 
up-to-date information about the Center's equipment, operating systems, and 
administrative policies for a wide spectrum of users. The principal 
publications are the MTS manuals which often rely heavily on U of M's MTS 
Manuals. U of M's series of MTS manuals when completed will consist of 
about a dozen 300-page volumes describing MTS in detail. The wsv cDPC will 
make completed U of M manuals available on campus when they likewise apply 
to MTS at WSU. When necessary, they will be revised and republished here to 
reflect changes made to MTS at WSU. Currently volumes 1 through.4 and 12 
have been revised and republished for use at WSU while volumes 5, 10, and 11 
are DU of M publications, 


Other introductory publications besides MTS manuals are also recommended 
at WSO. These publications are more specific, less costly to produce, and 
can thus be made available to students and other users at a lower cost than 
the more voluminous MTS manuals. An informal newsletter called OVERFLOW is 
published as needed (at least once per month) to inform users of changes 
taking place at the WSU CDPC. Other documents called Technical Memos are 
published by the Academic Services staff to provide detailed accounts of 
changes and additions to MTS or to provide tutorial information in some 
aspect of a computer application. Some of the Technical Memos are 
subsequently incorporated into MTS volumes. U of M Computing Center also 
produces CCMemos much for the same purpose. Often these CCMenos are equally 
applicable at WSU and those which apply are made available to users here. 
Other WS0 application program writeups exist which are in the sane category 
as Technical Memos but were not labeled as Technical Memos when they were 
published. 


The WSU CDPC tries to recover the printing costs of some documents it 
produces. These are sold through the main branch of the WSU bookstore. 
Other documents are freely given to users. Documents which the CDPC must 
purchase elsewhere are sold to users at our cost; these are usually either 
low quantity items or from lesser known publishers. Still others which cone 
from large volume publishers and are high volume items are best purchased 
through the WSU bookstore. 
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Sources for documentation are indeed complicated. However, the Academic 
Services Documentation Librarian can be consulted for details. General 
guidelines are as follows. UMTS manuals are purchased froa the WSU bookstore 
(both those published by WSU and 0 of M). Updates to MTS manuals are sent 
free of charge to any user who returns the Update Request Form (the last 
page of the manual). OVERFLOW is mailed free of charge to any user on the 
mailing list; contact the editor to be added to this list. Project 
directors are autosatically included on the OVERFLOW mailing list. Some WSU 
Technical Memos are distributed free of charge upon request to the 
Documentation Librarian; other high volume Technical Memos are sold at the 
WSU bookstore. Application program writeups are generally distributed free 
of charge for a single copy by the Documentation Librarian. 0 of M CCNenos 
are sent to users by the Documentation Librarian free of charge upon 
request. IBM manuals must be paid for by the user. The WSU bookstore can 
place orders for IBM manuals. If the user is a WSU faculty or staff member 
and if he wants IBM's updating service for IBM manuals, he may reguest IBM 
manuals from the Documentation Librarian. The CDPC will then bill hina for 
the cost of the IBM manuals and any subsequent replacement manuals issued by 
IBM, Users external to the University who do not have access to the WS 
bookstore can request any documents from the Documentation Librarian and be 
billed for these items by the CDPC. 


REFERENCE CENTERS 


Two locations on campus are maintained by the Academic Services Documen- 
tation Librarian as reference centers for documentation on computer utiliza- 
tion, These centers contain all commonly used documentation at WSU and also 
major manuals for use of the University of Michigan Computing Center and the 
Michigan State University Computing Center through the MERIT Computer 
Network. (See MTS Volume 4, "The MERIT User's Guide".) These locations are 
the main circulation desk of the WSU Science Library and room 333 
Adainistrative Services Building 2, 5950 Cass Avenue. Documentation may be 
perused at these locations which may be helpful in determining if purchase 
is necessary. 


WSU_MTS_DOCUMENTATION 
The following list describes the WSU applicable volumes of the thirdé 
edition of the STS manuals: 
Yol. 1, BTS -=- The Systes, revised April 1974, 480 pp. 
Introduces MTS and describes the command language, files and 
. devices, general batch and terginal use. 
vol. 2, Public File Descriptions, revised August 1971, 316 pp. 
Describes each of the public files available in MTS. 
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Vol. 3, Subroutine and Macro Descriptions, revised January 1972, 434 
PP. 
Describes the subroutines and subroutine libraries, and macros and 
macro libraries that are available in MTS. 


vol. 4, Terminals and Tapes, revised September 1973, 142 pp. 
Contains sections on conversational use of MTS, the MERIT network, 
and magnetic tapes. 


Vol. 5, Systea Services, December 1971, 232 pp. 
Describes the SORT utility program, text processing programs, the 
dynamic loader, and I0H/360. 


Vol. 10, BASIC in MTS, August 1971, 336 pp. 
Describes the BASIC language as implemented for MTS. 


Vol. 11, Plot Description System, April 1971, 164 pp. 
Describes the use of the CALCOMP plotter on MTS. 


Vol. 12, Pitt Interpretive Language, revised February 1974, 110 pp. 
Describes PIL, an interactive language, on MTS. 


HSU_INTRODUCTORY PUBLICATIONS 


Facilities & Services of WSJ Computing and Data Processing Center for 
Academic Users, February 1973, 42 pp. 
Describes the facilities and services that are available to users 
of the Wayne State University Computing and Data Processing 
Center. 


Introduction to MIS @ WSU, January 1974, 82 pp. 
Describes how to use the MTS command language at WSU to those 
users who are unfamiliar with the systea. 


ts of Available Software, issued quarterly, 54 pp. 


Abstract 
A listing of abstracts of many programs available at wWsuU. 


OTHER DOCUMENTATION RELEVANT TO MIS 


MIS Reference Card, WSU CDPC, February 1972. 
This concise, pocket-size card contains the MTS command language, 
editor commands, debug commands, CDPC telephone numbers, FORMAT 
(*FMT) commands, MTS BASIC, FORTRAN IV and other frequently used 
iteas. 
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CONTOUR, Richard Wiersma, WSU CDPC, March 1973, 50 pp. 
CONTOUR, a generalized surface approximation, contouring, and 
plotting programs is described. 


Iatroduction to SNOBOL4, ed. E. J. Fronczak, U of M Computing Center, 
February 1970, 25 pp. 


The S§NOBOL4 Programming Language, Griswald, Poage and Polonsky, 
Prentice-Hall, rev. ed., 1971. 


This programming language, developed at Bell Telephone Labs, is 
designed to be used chiefly for manipulation of character strings. 


SPITBOL Users’ Guide, ed. Ken DeJong, University of Michigan Coaputing 
Center and Richard Wiersaa, Wayne State University Computing and Data 
Processing Center, WSU CDPC, September 1973, 62 pp. 

This is a fast version of SNOBOL4 developed at the Illinois 
Institute of Technology. 


APL/360, Ap Interactive Approach, Gillman and Rose, Wiley, 1970. 
APL/360 Reference Manual, Pakin S., Science Research Associates, 1972. 


Digital Computing, FORTRAN IV. WATFIV. and MIS (with *FIN and *WATFIV), 
Carnahan and W#ilkes, published by the authors, Chemical Engineering 
Departament, University of Michigan, 1972. 


A GPSS Primer, Schreiber, preliminary printing, published by the 
author, School of Business Administration, University of Michigan, 
1972. ; 


A Compiler Generator, McKeeman, Hornung, and Wortaan, Prentice-Hall, 
1970. 
Describes the XPL programming language. 
Merit Computer Network User's Gyide, ed. Susan E. Colman, preliminary 
printing, published by Merit Computer Network, U of MM, MSU, WSU, 
April 1973, 60 pp. 


IPT Ii.5 Programming e, Kiviat, Villanueva, and Markowitz, 
Consolidated Analysis Centers Inc., 1973. 


SIMSCRIPT I2.5 Reference Handbook, Consolidated Analysis Centers Inc., 
1972. 


SIMSCRIPT 11.5 Programmer's Manual, WSU CDPC, May 1972, 56 pp. 


The above three manuals comprise the complete documentation for 
the SIMSCRIPT II programming language at WSU. 


Sany other books and sanuals could be listed in this section. Additional 


references are in Abstracts of Available Software and the mTS file 
HELP: DIRECTORY. 
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IBM MANUALS 


The MTS manuals will eventually describe fully the languages that were 
developed for use in MTS. They will also contain full descriptions of 
languages developed elsewhere and adapted to use in MTS, such as PIL, but 
for which descriptions are not readily found in the existing literature. 
However, languages developed by IBM and adapted to MTS are described only 
briefly in the MTS manuals. For these languages, the user should refer to 
the appropriate IBM manuals for a complete description. 


The IBM manuals listed below are important to a better understanding of 
use of the computer and the specific IBM language processors available in 
MTS. These manuals can be purchased from the WSU main bookstore, but users 
must supply the correct form number when ordering them. The CDPC Academic 
Services Documentation Librarian has a complete bibliography of IBM publica- 
tions, and will gladly assist users in finding the correct form number. 


Hardware Description 
IBM System/360 Principles of Operation--form GA22-6821 
IBM System/360 Model 67 Functional Characteristics--form GA27<-2719 
IBM System/360 System Summary-eform GA22=-6810 


Assembler 
IBM System/360 Assembler Language--form GC28=-6514 


Reference Data 
IBM System/360 Reference Data--form GX20-1703 (also known as_ the 
"green card") 


IBM System/360 FORTRAN IV Language--form GC28=-6515 

IBM System/360 FORTRAN IV Library Subprograms--form GC28=-6596 

IBM System/360 FORTRAN IV Library: Mathematical and Service 
Subprograms--form GC28-6818 

IBM System/360 Scientific Subroutine Package--form GH28=0205 


IBM System/360 PL/I Reference Manual--forma GC28-8201 

IBM System/360 PL/I Subroutine Library--form GC28=-6590 

IBM System/360 PL/I (F) Programmer's Guide--form GC28-6594 
(Although IBM system-dependent, this manual also contains 
much useful information on writing correct PL/I programs.) 

A PL/I Primer--form SC28=-6808 

A Guide to PL/I for FORTRAN Users--fornm SC20-1637 


FORTRAN to PL/I Converter 
System/360 Conversion Aids: FORTRAN IV-to-PL/I Language Conver= 
sion Program for IBM System/360 Operating System=--360C-cV- 
710--form GC33-2002 
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‘APL/360 Primer--fora GH20-0689 
APL/360 User's Manual--form GH20-0683 


ALGOL ‘ . 

IBM Systea/360 Operating System ALGOL Language--fora GC28=-6615 

IBS Systen/360 Operating System ALGOL Programmers Guide--fora 
6C33-4000 


IBM Systea/360 American National Standard COBOL--form CG26-6396 
(Although IBMesystea-dependent, this manual also contains 
auch useful information on writing correct programs.) 

IBM Systea/360 American National Standard COBOL=*~form GC28=6399 


SSuP 
Systen/360 CSHP: Application Description--form GH20-0240 
Systea/360 CSHP: User's Manuale-fora GH20-0367 
Systea/360 CSNP: Syster Manuale-fora GY20-0111 


SPSS 
GPSS/360 Introductory User's Manuale-form GH20-0304 
GPSS/360 User's Manual--fora GH20-0326 


BPS 
Mathematical Prograsuing System/360: MPS Application Description- 


~fora GH20-0136 

Mathematical Prograsgsing System/360: MPS Control Language User's 
Manuale--fora GH20-0290 

Mathematical Prograasging Systes/360: MPS Linear and Separable 
Proragaing User's Manual--fora GH20-0476 

Mathematical Prograasaning Systen/360: MPS Messages Manual--forn 
GH20-0603 
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INTRODUCTION TO MTS 


The IBM 360/67 can serve a large number of users concurrently, offering 
each a wide variety of services. The job of keeping track of all the 
programs in the machine and of devoting some attention to each of then every 
second or two is handled by the MTS operating system (Michigan Terminal 
System). In order to request service from the computer, you smust first 
identify yourself to MTS and then communicate your requests. This comauni- 
cation is done through the MTS Command Language. Because the system is both 
powerful and complex, the command language of MTS is a rich one. Fortunate- 
ly, MTS usually has a default option wherever it offers you a choice; that 
is, if you don't state your choice explicitly, a plausible assuaption is 
made and the job continues. In the following sections, some of the more 
important commands are discussed. For a complete listing, see the section 
entitled "A Brief Overview of MTS" in this volune. 


You may operate within MTS in one of two modes - batch or conversational. 
In conversational node, you sit at a terminal and communicate directly with 
MTS through a typewriter-like keyboard. MTS processes each command as it is 
received and reports the results. Based on the results, you can decide what 
command to give next. Thus, conversational mode of operation is highly 
interactive. 


Batch mode, on the other hand, is not interactive. You must completely 
pre-plan all requests, punch them on cards, and submit thea to the Computing 
and Data Processing Center (CDPC), directly or through a distribution 
station. Some time later -- minutes or hours, depending on how long your 
program is and how busy the computer is == you may pick up the results. 
Feedback is not immediate. Details on submitting a program using a terminal 
or in batch are found in the manual [Introduction to MTS @ WSU (January, 
1974) and the sections “Conversational Usage of MTS" and "Batch Usage of 
MTS" in this volume. 


The command language and its usage are essentially the same for both 
batch and conversational modes. The primary difference is that in conversa= 
tional mode MTS replies after most commands, confirming what it just did or 
prompting you for further information. The descriptions that follow apply 
to both modes; any substantial differences between them are noted as they 
occur. 


INTRODUCING YOURSELF TO MTS \ 


Here, and in later sections, the eaphasis is on illustrative examples 
accompanied by "rules". This is not the whole MTS story by any means, but 
it should serve as an introduction to the more detailed descriptions in the 
rest of the manual. 
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Example 1 is a trivial job that illustrates four rules about the NTS 
command language: 


hh OOO 
1 SSIGNON MYID PW=SESAME "W NAME*® | 
{ S$SIGNOFF \ 
a 


Example 1. 


Rule 1: The first character of a command to MTS is a 
“gr, In batch mode, the “first character" is the 
character in column 1 of a card. In conversational 
mode, the “first character" refers to the first charac- 
ter you type in a line. (A blank is considered to be a 
character.) Though there are cases in which the "5" 
need not appear, it is always acceptable to include it. 


Rule 2: The first card or typed line must say SSIGNON 
and sust be inrsediately followed by one or more blanks 
and your user identification code. This first part of 
the identification is the four-character ID code (e.g., 
HYID) given to you by the Computing Center. The next 
part is the 1-6 character password associated with the 
ID. More is given on passwords below. 


le 3; The last command, $SIGNOFF, tells MTS that you 
have finished using its facilities. STS then gives 
statistics on the cospleted run, e.g., how auch it cost, 
how long it took, etc. The S$SIGNOFF command is not 
necessary to terminate a batch job. 


RE 4; For batch users only, a delivery code and nane 
should appear within single quotes. The delivery code 
indicates where the printed and/or punched output is to 
be delivered. The letter "W" indicates that the output 
is to be sent to roon 73 of the Science Library. A 
blank indicates that the output should be retained at 
the control desk of the CDPC, 5925 Woodward Avenue. The 
nase is used for identification and should be separated 
from the delivery code by a blank or comma. For a 


listing of delivery codes, see Facilities and Services 
Center for 


of 489 Computing and Data Academic 
Users or the file HELP:DELIVERY. 


The purpose of the password is to keep others from using your signon ID. 
It is prudent to conceal it. One step toward this goal is to leave the 
password off the SSIGNON command and to supply it on the next card or line. 
This second card is not printed with your output in batch aode, and it is 
recoamended that you turn off the printing on the keypanch or terminal when 
you type it. The "three~line" sequence in Example 2 has exactly the same 
effect as Example 1 and is the preferred aethod of signing on. This sethod 
is used in all subsequent exauples. 
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—_— 
{| SSIGNON MYID 'W NAME* 

| SESAME 

{ SSIGNOFF 
ee | 


Exasple 2. 


—~ am oe ed 


In conversational aode, if you don't include the password on the first line, 
MTS prompts you for it by typing “ENTER USER PASSWORD". 


When you get a signon ID from the CDPC, a password is already assigned to 
it. You probably will want to change it to something more meaningful and 
hence more easily remembered. The SSET command is used to change your 
password. To change from your current password, OLDPAS, to a new one, 
NEWPAS, you can include the $SET command as part of any job: 


are oe 
1 SSIGNON MYID ' NAME*| 
| OLDPAS 


{ 
| SSET PW=NEWPAS | 
1 SSIGNOFF { 
ee | 


Example 3. 
From this point on, your password is NEWPAS. 


When you SSIGNON in batch, MTS allows you a maximum of 30 seconds of 
processing time, 50 pages of printed output, and 0 punched cards. If you 
want more or less of any of these items, you can specify the request on the 
$SIGNON card as shown in Example 4 below. 


Rule 5: To set the time, you write 
"T=tinme*® in seconds. This example 


oc requests 90 seconds, If you prefer 
{| $SIGNON MYID T=90 P=10 C=50 * ME*{ to use units of minutes, you may 
$d write T=1.5m, where 4s indicates 
Example 4. ninutes. To specify pages and 

cards, you write "P=nuaber of pages" 

and "C=number of cards", This 


example asks for 10 pages and 50 
punched cards. 


These parameters serve only as a maximum; you may use less but you cannot 
use more. For a more detailed description of these and additional options 
for the $SIGNON command, see the description of the command language in this 
volume. In terminal mode, these options are ignored. 
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NOW _ZHAT _BTS_KNOWS WHO YOU ARE 


Now you can get the computer to do some real work for you. Let's say 
that you have some problea for which you have written a FORTRAN or WATFOR 
program. In order to run this program, i.e., to have the computer carry out 
your instructions, several steps are required: 


1. The prograa you write in FORTRAN or WATFOR or any other language is 
known as the source program. A translator must translate your source 
program to a machine language object progras. If you wrote the program 
in FORTRAN, then you use the FORTRAN compiler to translate your PORTRAN 
staterzents. If you used WATFOR statements, the WATFOR compiler aust do 
the translating. The sare is true for other Languages. 


2. ‘The object program must be loaded into computer nesory. 


3. MTS can then execute your object programs, that is, it can carry out the 
- dnstractions in your program. Let's look at some sample WATFOR jobs. 


Rule 6; S$RUN *WATFOR tells ATS to 
execute the program contained in the 
public file *WATFOR. The program in 


SSIGNON MYID © WNAME* file *WATFOR is the WATFOR coaspiler. 


{ I 

{ SESAME { (A compiler is_ one type of 
| SRUN *WATFOR { translator.) 

{ SCOMPILE 1 

{ READ, { 

t U=SQRT (X) 1 Rule. __7: The control cards 
| PRINT, X,0 | SCOMPILE, SDATA, $STOP are comauands 
t STOP { to WATFOR, not to ATS. SCOMPILE 
( END { says “here comes a program for com 
ij SDATA { pilation". S$DATA denotes the end of 
{ 21.67035 { the source code and calls for execu- 
{ S$sTOP { tion of the compiled program; it 
{| SSIGNOFF { must be included whether or not you 


have any input data. SSTOP tells 
Example 5. WATFOR to turn control back to MTS. 


A succession of WATFOR tasks can be run by alternating SCOMPILE and SDATA 
commands as shown in Example 6. 
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S$SIGNON MYID °* 
SESAME 
SRUN *WATFOR 
SCOMPILE 

(Source cards for Job #1) 
SDATA 

(Data cards for Job #1) 
$COMPILE 

(Source cards for Job #2) 
SDATA 

(Data cards for Job #2) 
$STOP 
$SIGNOFF 


NAME* 


Example 6. 


Example 7 shows a sample FORTRAN job. 


$SIGNON MYID ! 

SESAME 

SRUN *FIN 
(FORTRAN source cards) 

SENDFILE 

SRUN =LOAD 

21.67035 

SENDFILE 

SSIGNOFF 


NAME® 


Exaaple 7. 
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Alternating SCOMPILE and 
SDATA cards is more efficient than 
executing the WATFOR prograa sepa- 
rately each time. Note that these 
tasks are independent. If you have 


Rule 8: 


a main program and several subrotu- 
tines which are to be executed 
together as a unit, they constitute 


one task and thus need only one 
S$COMPILE and one S$DATA card. In 
this case, WATFOR distinguishes the 
end of one routine from the begin- 
ning of the next routine by the END 
card which must be the last card of 
any WATFOR routine. 


le_93 SRUN *FTN performs a sini-~ 
lar function to S$RUN *WATFOR in 
Example 5; i.e., it tells MTS to 
execute the program in the file 
*FTN, which contains the FORTRAN 
compiler. 


Rule__ 10: SENDFILE is used to sig- 
nify the end of the source code and 
again to signify the end of the 
data. It is not a command. 


Rule 11: Execution of your con 
piled program is invoked by the card 


$RUN =LOAD. This instructs MTS to 
run the program stored in a file 
called -LOAD. Fortunately, this is 


where *FTN has just put your 
program since the first RUN command 
gid not specify where the object 
program was to be stored. 


ob ject 


This example points out a saajor difference between WATFOR and FORTRAN: 
namely that FORTRAN requires that the translated program be stored somewhere 
before running it, while WATFOR does not. 


Introduction to MTS 19 


MTS Volurvne 1: MTS «-- The Systen 


April 1974 


AND NOW ANOTHER WORD ABOUT THE MTS COMMAND LANGUAGE 


So far, we have encountered several "words* of the MTS command language. 
There are many more, some of which are discussed in the section on files 
that follows. In general, the command statements have a fairly free format. 
A safe rule is: 


Rule 12: Don't leave a space between the dollar sign 
and the cormand word. in general, you should leave a 
space between "words" when there is no explicit separa- 
tor, such as in SSIGNON MYID. However, if there is a 
separator such as an equal sign (=), you should not 
leave any spaces around it. For exaraple, within the 
"phrases" PW=SESAME and T=30 there should be no blanks. 


The experts know abbreviations for the command words, but in general, the 
first three letters of the command are sufficient. Check to be sure. 


Several different tasks can be performed between a single SSIGNON- 
$SIGNOPF pair. Example 6 showed a sequence of WATFOR tasks; you can have a 
sequence of WATFOR and FORTRAN tasks; in general, you can have almost any 
sequence of tasks, whether or not they are related. 


| ZHE_MYSTERY OF PILES ONVELLED 


MTS is a file oriented system that stores files on disk storage. The 
best way to think of a file is as an area of this disk storage in which you 
can store information. 


Piles are corposed of lines of information. If information is put in the 
file via the card reader, then a line is the contents of one card. If the 
information is put in the file by a FORTRAN program, then generally a line 
is the information contained in one FORTRAN output record. If the 
information is put in the file via a typewriter terminal, a line is the 
inforration typed before the "return" code is typed. The information 
contained ina file could be data, an object program, the FORTRAN compiler, 
a source programs, a letter to the President, etc. Every file has a name _ so 
that you can communicate with MTS about it. 


Sore operations that can be done with files are: SCREATE thea, and 
SDESTROY then, $LIST therm and $COPY them, SGET them and SRELEASE thea, SRUN 
then, and SEMPTY them. How to carry out these operations is the subject of 
this section. 


Sone examples of $RUNning files have already been seen. SRUN *WATFOR 
commands MTS to execute the program stored in the file called *WATPOR. 
Since the WATPOR compiler is the program contained in the file named 
*WATFOR, MTS makes WATFOR start corpiling or translating your progran. 
Sisilarly, SRUN *FTN begins the execution of the FORTRAN compiler in the 


20 Introduction to MTS 


MTS Volume 1: MTS == The Systen 


April 1974 


file named *FTN. SRON “LOAD, in Example 7, requests the execution of the 
program in the file -LOAD. Since the object program has just been stored in 
“LOAD by *FTN, it is this program that is run. 


The most common type of file is one in which every line in the file has a 
number associated with it. These are called line files and for the purposes 
of this introduction, when the word "file" is used, we are referring to a 
line file. The line file is ordered by its line numbers. Thus, regardless 
of the order in which information was entered into the file (even if you 
gave line 10 before line 9), the information is effectively stored in the 
file with the line numbers in ascending order. 


There are two ways to specify the line number which is to be associated 
with a line. One way is to write the numbers yourself at the beginning of 
each card or typed line. However, files are usually filled initially with a 
set of sequentially numbered lines, and MTS might as well number them for us 
via a SNUMBER command shown below. 


Creating a File 


Example 8 shows a simple batch job that creates a file called FILEFACTS, 
puts five lines of information into it, and then lists it. Example 9 is the 
same job but run in conversational mode. 


S$SIGNON MYID * NAME* 

SESAME 

SCREATE FILEFACTS 

SNUMBER 

THIS SAMPLE FILE CONTAINS SOME 
INFORMATION ON PILES IN MTS. 
1. A FILE IS A SET OF NUMBERED 
LINES STORED UNDER SOME UNIQUE 
NAME 

SU NNUMBER 

$LIST FILEFACTS 

SSIGNOFF 


Example 8. 


Rule__13: A file can be created by $CREATE followed by 
the name you wish to attach to it. It is retained for 
your later use until you SDESTROY it. 


Rule 14; The command $NUMBER instructs MTS to number 
the lines that follow. In batch mode, MTS numbers’ the 
lines as they are put in the file. In conversational 
mode, MTS types the line number for you and then waits 
for you to type the content of that line. The numbering 
starts with 1 and goes up by increments of 1 thus giving 
Ve 2edyee5 See the S$NUMBER command description in the 
Command Language section of this volume for ways of 
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specifying a different starting nuseber or different 
incrersent. If the SNUMBER command is not given, lines 
to be put into the file must be nuabered explicitly. 


Rule. Once a file has been $CREATEd, you may enter 
information into it. MTS must be able to distinguish 
commands to be executed from text to be stored in a 
file. All lines of information which (1) start with a 
line nuaber (either explicitly or via SNUMBER) and (2) 
do not have a single *"$* following the nuaber are put 
into the active file. The currently active 
file is the file whose name most recently appeared in a 
SCREATE or S$GET statement. (S$GET is explained below.) 
Any line not starting with a line number or containing a 
Single "$" after a line thumber is assumed to be a 
command to be executed immediately. If the command is 
not legal, MTS gives an error comment. 


Rule. 16: SUNNUMBER turns off the automatic line 
numbers effected by SNUMBER. MTS still puts any lines 
with explicit line nusbers into the file unless a single 
"$*" follows the line number, or the file is SRELEASEd. 


Rule 17; ‘$LIST, followed by a file name, calls for a 
listing of the contents of the file starting from line 
1. If the file has line numbers less than 1, they are 
not listed. The listing includes the line nyabers. 


The following example was done on a terminal. The statements typed by 
the user are in lower case and the output to the user is in upper case. 
This example illustrates the concept of a prefix character. In an actual 
Session, the area for the password would be blacked out by MTS and "sesame" 
would not be readable, 
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MTS (L033-0034) 
#$signon myid 
#ENTER USER PASSWORD 
?sesame 
#**LAST SIGNON WAS: 141:244.45 02-21-73 
# USER "MYID"® SIGNED ON AT 12:07.00 ON 02-21-73 
#$create filefacts 
# FILE "“FILEFACTS* HAS BEEN CREATED. 
#$ number 
1_ this sample file contains some 
2_information on files in mts. 
3_ 1. a file is a set of numbered 
4 _ lines stored under some unique 
5_name. 
6_Sunnusber 
$list filefacts 


VVV VV © © HH we He 


1 THIS SAMPLE FILE CONTAINS SCME 
2 INFORMATION ON FILES IN MTS. 
3 1. A FILE IS A SET OF NUMBERED 
4 LINES STORED UNDER SOME UNIQUE 
5 NAME. 
#END OF FILE 
#$signoff 
#OFF AT 12:08.54 02-21-73 
#ELAPSED TIME 1.929 MIN. $ .09 
#CPU TIME USED 1.366 SEC. $.12 
#CPU STOR VMI «116 PAGE-MIN. $.01 
#WAIT STOR VMI -187 PAGE-HR, 
#DRUM READS 53 
#APPROX. COST OF THIS RUN IS $.22 
#DISK STORAGE 13.35 PAGE-HR. 


#APPROX. REMAINING BALANCE: $526.76 


Example 9. 


Rule 183: The prefix character is typed by the systen 
and is the first character of every line of output and 
the first character on a line expecting input. This 
character identifies who is producing the output line or 
who is expecting input. Each segment of the system has 
a distinct character. In this example the "#" appears 
in MTS command mode and the ">" appears when a listing 
is being produced. A complete listing of the systea 
prefix characters is given in the "System Command 
Language" section in this volume. 
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Revising a Pile 


Suppose that you find after creating a file that you have left out a line 
in the siddle and intended to say more in line 5. You can edit your file on 
a subsequent run as shown in Example 10. 


Bule_ 19: At the start of this ran, 
there is no currently active file. 
$GET is used to notify MTS of the 


4 SSIGNON MYID * NAME? 1 name of the file to be the active 
] SESAME { file. SGET FILEFPACTS makes FILE 
1 $GET FILEFACTS { PACTS the active file, regardless of 
12.5, YOU SHOULD LEARN THEM. | whether or not another file had 
1 5,NAME ASSIGNED BY THE USER. | previously been the active file. 
{1 SSIGNOFF { SRELEASE releases a file from being 
Benen arene nnrenennnninenamneniseenmmininenimmeninal the currently active file, thus 

Example 10. returning to the status of no cur= 


rently active file. 


Rule 20; If SNUMBER isn't used, each line aust be 
numbered explicitly; the number may be separated from 
the text by a comma. (When a blank is used as a 
separator, it remains part of the text. A comma, 
however, used as a separator is stripped off.) If there 
is no line number, MTS assumes the line is a command to 
be executed immediately. 


Rule_21:; A line can be inserted between existing lines 
by giving it some intermediate number. This number can 
be fractional, or even negative. (But note that as 
stated in Rule 17, $LIST still lists starting froa Line 
1 (unless you take special precautions) even if your 
file has a line nuabered .5.) 


A line with a number already in use in the file calls for a replacenent 
of the old line with the new. Thus, in this example, the old line 5 is 
replaced by the new one. 


After running Exanple 9 and then 10, FILEFACTS has 6 lines: 
%,2,2.5,3,4,5. 
Copying a File 

After a certain amount of editing and insertion of new lines, a file may 
get rather asessy, i.e., full of interpolated lines. For this or other 


keasons, you may want to copy the information into a new file. Example 11 
shows how to do this. 
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Rule 22: The S$COPY command copies 
the contents of one file into anoth- 
er. In this process the lines are 


SSIGNON MYID © NAME* numbered sequentially from 1 as they 


{ | 

| SESAME ( enter the new file regardless of 

{ SCREATE NEWFILE { their line numbers in the old file. 

| SCOPY FILEFACTS TO NEWFILE | The old file is retained unaltered. 

| SSIGNOFF { For ways of copying only part of a 

a ed file or of altering the numbering in 
Exaaple 11. the new file, see the $COPY command 


description in the "Command Lan- 
guage" section of this volume. 


Rule__23: Information that is no longer wanted can be 
deleted either by a command of the form 

SEMPTY FILEFACTS 
which removes the contents of the file but retains its 
identity, or by a command of the forn 

SDESTROY FILEFACTS 
which deletes the file and returns the space on the disk 
to the pool of available storage. 


Most of the time, you will want to use files for programs or for data. 
Example 12 shows the compilation and execution of a small WATFOR progran 
which is set up in such a way that the source program is left in a file for 
later use. One method for putting lines that start with "$* into a file is 
illustrated. An alternate method is shown in Example 17 below. 


SSIGNON MYID * NAME® 


SESAME 

SCREATE PROG 

SNUMBER Rule 24: To prevent a card like 
SSCOMPILE SCOMPILE from looking like an 4#TS 


DIMENSION K (5) 
po 10 I = 1,5 
10 K(I) = (I*#5) +7 


command for immediate execution, 
lines beginning with a single "$", 
whether they are preceded by a line 


STOP number or not, are not entered into 
END files but are treated as MTS cone 
SSDATA mands. Lines beginning with a line 
$$STOP humber followed by "$$" are entered 
SUNNUMBER into a file with the first "g" 
SRUN *WATFOR SCARDS=PROG removed. 
SSIGNOFF 


Example 12. 
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The $RON card needs some further explanation. WATFOR has to read 
input--your source program. It must know where to find the input. Is it on 
a card reader or on a terminal or in a file? And in which of the many card 
readers, terminals, or files is it? It is undesirable to have WATFOR always 
expect its input to come from a particular input device. Imagine what would 
happen if WATFOR insisted that all users input their programs from the third 
terminal in Room 58 of the Science Library--there would be an intolerable 
line at that particular terminal and the others would probably be idle. 
This same problem arises for any program--be it the PORTRAN or WATFOR 
compiler or your own program which wants to read or write data. 


To avoid the necessity of specifying a particular input or output device 
at the time of writing the program, MTS provides for logical 1/0 (input- 
output) ygnits. These are sysbolic names and do not refer to actual physical 
units. The nost commonly used logical I/0 units are SCARDS, SPRINT, SPUNCH, 
0,1,2¢+e0,19. The WATPOR compiler is an example of a program which uses the 
logical units SCARDS and SPRINT. It reads the source statements fror 
logical unit SCARDS and writes the source listing on logical unit SPRINT. 
It depends on MTS to tell it at execution tize which physical devices are 
associated with the logical units. It is up to you to give MTS this 
information. 


At the time the SRUN command is given, you must specify, for each logical 
I/O unit used by the program to be run, which actual physical unit should be 
used. (In many cases, if you do not specify which device should be attached 
to the logical I/O unit, MTS makes a plausible assumption. This is 
discussed below.) Thus, in Example 12, the specification SCARDS=PROG on the 
$RUN command tells MTS to tell WATFOR that the source program is in a file 
named PROG. The reason that our earlier examples didn't have to specify 
SCARDS and SPRINT is that if MTS is not told explicitly, it assumes that 
SCARDS refers to the device from which the SRUN command came and that SPRINT 
refers to the device that it has been using to print the command cards. 


In the above example, if you wanted your programa to read data and had a 
statement such as READ,X as in Example 5, WATFOR would assume the data could 
be found in the file PROG since you said SCARDS=PROG. But if you are likely 
to be varying the data, you would not want to put your data in PROG. You 
might want to keep your data on cards or ina different file. Example 13 
illustrates how to read your data from cards, even when your source prograr 
is ina file. 
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Rule 25; The statements READ(5,1) 
X and WRITE (6,1) X,U tell WATFOR to 
use logical unit 5 for input and 


$SIGNON MYID * NAME® logical unit 6 for output. Only the 


{ { 

( SESAME { numbers 1,...19, are acceptable in 
{ SCREATE PROG | these statements. Use of different 
{| SNUMBER ] numbers or of SCARDS, SPRINT, SPUNCH 
| SSCOMPILE { is illegal. This is true in FORTRAN 
] READ(5,1) X 1 as well as WATFOR. 

{ 1 FORMAT (2F10.5) { 

{ U=SQRT (X) | 

( WRITE (6,1) X,U { Rale_ 263 In the $RUN command, you 
{ STOP I must tell MTS with what to equate 
i END ] logical units 5 and 6. In exaaple 
{ SSDATA { 13, 5S=*source* and 6=*sink*, where 
{ SS$STOP 1 *SOURCE* and *SINK* are known as 
{ SUNNUMBER { pseudo-device names and are 
{ SRON *WATFOR SCARDS=PROG =| explained in the next two 
( 5=*SOURCE* 6=¥*SINK* |[ paragraphs. 

| 21.67035 { 

{ SSIGNOFF | 


Ryle 27: If an MTS command line is 
Example 13. too long to fit on a single input 
line (card or terminal line), a 
minus sign may be placed in the last 
column to indicate that the next 
line is to be considered as a con- 
tinuation of the first line. The 
last column of a punched card is 
column 80; the last column of a 
terminal line is the last character 
typed before "return" is signaled. 


You want MTS to tell WATFOR where the commands are coming from. If you 
are in batch mode, logical unit 5 is the card reader. Tf you are in 
conversational mode, logical unit 5 is the terminal you are typing on. 
Similarly, you want 6 to be a line printer or a terminal, depending on what 
mode you are in. In batch aode, you do not care on which card reader your 
deck was placed or which line printer you are using. If a particular line 
printer, for example, is broken or is being used by someone else, you would 
prefer that MTS gives you a different one instead of waiting for that 
particular one. If you are using a terminal, you would prefer not to have 
to worry about finding out some identification number for the terminal at 
which you are sitting. So you use another gimmick to avoid having to be too 
specific, the idea of a pseudo-device. Pseudo-devices allow you to take 
advantage of the fact that, even if you don't know, MTS does know what 
device your $SIGNON came from and which line printer it can use if you 
require one. 


Wherever you have to name a file or device, you can use a pseudo-device 


name and let MTS assign a real physical device or file to the name. 
Pseudo-device names are characterized by the fact that they start with an 
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asterisk followed by some string of alphabetic characters and end with an 
asterisk. The sost important pseudo-device names which are predefined by 
MTS are *SOURCE*, *SINK*, *PUNCH*, and *DUMMNY*: 


*SOURCE* means that you want the same device from which MTS has been 
receiving its commands. Thus, in batch mode, *SOURCE* is equated 
with the particular card reader from which your batch job is being 
read. In conversational mode, *SOURCE* is assigned to the terminal 
which you are currently using. 


*SINK* refers to the current output file or device. In batch mode, MATS 
assigns *SINK* to the line printer assigned to your job. In 
terminal operations, *SINK* is equated with the terminal you are 
using. 


*PUNCH® refers to the card punch in both batch and conversational aode. 


*DUMMY* is a name that can be used as an input or output device. If you 
read from *DUMMY*, you always get just an endeof-file. Used as an 
output device, it acts like an infinite wastebasket -- you may 
write as much as you want on it, but it is lost forever. 


Example 14 shows how you can put your data into a file called DATA and 
then run the program that you put in file PROG using the data in the file 
DATA. 


Rule 28; Now logical unit 5 is set 
to DATA since that is where the 


SSIGNON MYID * NAMES 
‘ program is reading the data fron. 


SESAME 

SCREATE DATA 

SNUMBER 

2.173 

3.576 

4.873 

SUNNUMBER 

SRUN *WATFOR SCARDS=PROG 
S=DATA 6=*SINK* 


SSIGNOFF 


Example 14. 


Exaaples 15 and 16 show the corresponding procedure for FORTRAN. 
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$SIGNON MYID ° 
SESAME 
$CREATE FPROG 
$NUMBER 

READ (5,1)X 
1 FORMAT (2F10.5) 

U=SOQRT (X) 

WRITE (6,1) X,U 

STOP 

END 
SUNNUMBER 
$CREATE OBFILE 
$RUN *FTN PAR=SOURCE=FPROG 

LOAD=OBFILE 

$RUN OBPILE 5=*SOURCE* 6=*SINK* 
21.67035 
$ENDFILE 
$SIGNOFF 


NAME* 


Example 15. 


SSIGNON MYID ! 
SESAME 

SRUN OBFILE 5=*SOURCE* 6=*SINK* 
3.1416 

SENDFILE 

SSIGNOFF 


NAME* 


ee | 


Example 16. 


If you wanted to put the data into a file, you 


procedure as in Example 14. 


In Example 12, there 
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Rule 29; When the source cards are 
read froma private file, it is not 
necessary to use a $ENDFILE card to 
Signal the end of the input. MTS 
automatically supplies an "end of 
file" indicator when the end of the 
file is reached. 


Rule_ 30: To tell FORTRAN to put 
the object program into a private 
file, one specifies "LOAD=filenane" 
in the “PAR=" field of the SRUN *FTN 
card. If a file in which to put the 
object program is not specified, the 
object program is held teaporarily 
in -LOAD but is then not available 
for subsequent jobs. By saving the 
object program as in Exasple 15, you 
do not have to recompile the source 
program in Example 16. Note that 
this could not be done with *WATFOR 
since the WATFOR compiler does not 
provide facilities for retaining the 
object program. 


would follow the sane 


is a WATFOR program in a private file PROG. The 
following example shows a way of getting the 


same information into PROG 


without worrying about double dollar signs. 
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SSIGNON MYID * NAME* 
SESANE 

SCREATE PROG 

SCOPY *SOURCE* TO PROG 


Rule. .31:  § The SCOPY command tells 
MTS to copy everything up to the 
first endeof-file indicator it sees. 


| ! 

{ I 

t ! 

| ] 

{| SCOMPILE ( 

t DIMENSION K (5) { Since MTS is just looking for the 
1 po 10 Ir=1,5 { end-of-file mark, lines which 
4 0 K (I) = (1*5) +7 1 ordinarily would be comamands requir- 
t STOP { ing execution are copied blindly 
i END 1 into the file. When $COPYing fro 
| SDATA. { *SOURCE*, the S$ENDFILE line serves 
| S$sTOP { as the end=-of-file indicator. 

{| SENDFILE { . 

{ SRUN *WATFPOR SCARDS=PROG t 

| SSIGHOFF | 


i 


Example 17. 
BUT_HERE'S SORE ABOUT PILES 


The examples so far have dealt primarily with private files, i.e., files 
created by the user for his personal ase and retained from job to job. 
There are two other types, temporary (sometimes called scratch) files and 

Se A temporary file has a name beginning with a negative sign. 
You may create and use temporary files just as you do ordinary private 
files. The only difference is that at SSIGNOFF all tesporary files you 
created aré destroyed. As your eligibility for private files is lisited, 
you should use temporary files whenever possible. <LOAD is an example of a 
teraporary file; in this case *FTN automatically creates it for you unless 
you specify LOAD to be some other file. 


Most public files have a nase beginning, but not ending, with an 
asterisk. They may also begin with CCAP:, HELP:, DEMO:, NEW: or OLD:. 
Anyone may use one, but only the elect may create one. Exaaples so far have 
only dealt with public files *WATFOR and *FTN. For a complete listing of 
all the public files available, see Volume 2 of the MTS manuals, File 

« Two more useful public files are *STATUS and *CATALOG. 
Example 18 shows a run that combines these. 
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Rule__32: The prograrg in *STATUS 
asks MTS to give you a summary of 
all your computer usage with the ID. 
You get information such as how such 
money you have used and how guch is 
left in your account, how much file 
space you have left, and so on. 


$SIGNON MYID * NAME! 

SESAME 

SRUN *STATUS 

$RUN *CATALOG 

S$SIGNOFF 

fe | 

Example 18. Rule _ 33: The program in *CATALOG 
lists all the private (permanent) 
files that you have currently occu=- 
pying space on disks, that is, all 
those that you have SCREATEd at some 
time but never $DESTROYed. 


Ordinarily, you are the only one who can read or write on a file which 
you created. If you want to let other people read your files, you may set a 
“permit code" that allows it. If, for example, you feel that NEWFILE 
created in Example 11 ought to be made available to others, you can so 
specify. Example 19 shows how this is done. 


Rule 34: After the S$PERMIT, you 
then name the file you want to 
PERMIT and say what permission is to 
be extended. ALL seans that file 


{ SSIGNON MYID * NAME* 


{ 
1 SESAME 1 may be read by all MTS users. No 
{| SPERMIT NEWFILE ALL t one but the owner of the file say 
| SSIGNOFF 1 change it. You can later reverse 
en a ed this effect by issuing the S$PERMIT 


Example 19. command and specifying NONE after 
the name of the file instead of ALL. 


Now another user can read your file: he can copy it, run it (if it is an 
object program), or read it as data. Example 20 shows how user ABCD might 
copy NEWFILE. 
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SSIGNON ABCD * NANE* 
ALIBAB 
SCREATE XEROX 


e 35; Reference to files other 
than your own requires the owner's 
ID code and a colon (:) immediately 
SCOPY MYID: NEWFILE TO XEROX preceding the file nane. This is 
SSIGNOFF necessary since dozens of users may 
pee erator have files called NEWFILE. 

Example 20. 


To conclude this section, usually input-output devices and files are 
interchangeable under MTS. You may either think of a file as a substitute 
for an input-output device, or the reverse. Examples of this interchangea- 
bility have been presented in such phases as SCARDS=*SOURCE* which refers to 
a device and SCARDS=MYFILE which refers to a file. 


A_LAST_WORD CONCERNING TERBINALS VS: BATCH 


All of our examples are applicable to batch or conversational modes. The 
main difference between the two is that in conversational mode, you get 
immediate feedback from MTS after giving it a command. This can be very 
helpful if you have made an error. For example, if you misspell the name of 
a file and MTS cannot find it, it asks you to try another name. If you ask 
MTS to $SDESTROY or SEMPTY a file, it asks you to confirm the request. To do 
this, you type in either "OK" or "0.K.",. If you change your mind, type in 
anything except OK. 


Another difference in conventions between batch and terminal operations 
occurs in the running of *FTN and *WATFOR. Whereas in batch mode you get a 
listing of the source program and error comments, on a terminal the source 
code is normally pot listed. Only the erroneous lines and their error 
messages appear. 


H If you want your source prograg listed when 
running *FTN from a typewriter terminal, add the phrase 
PAR=SOURCE to your SRUN *FTN line. Note that there are 
no asterisks in SOURCE. With *WATPOR, to get your 
source program listed, you must include the parareter 
SOURCE on your SCOMPILE card or line. 


When you are entering text into a file, the text begins after the line 
number and any separator sysbol that accompanies it. Thus, if you are 
entering a FORTRAN or WATFOR program and you want the text to start in 
coluan 7, you must give six spaces before you type the line. There are two 
ways to avoid all the “space~bar hitting". All terminals have tab setting 
features which say be used. See Volume 4% Jersinals and Tapes for the 
particular terminal being used. In addition, the FORTRAN conpiler in *FTN 
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accepts programs in free=format and the program in file *FORTEDIT may be 
used to convert your statements from free-format to standard FORTRAN format. 
(See Volume 2 for descriptions of *FTN and *PORTEDIT.) 


If you wish, you can create a batch job froma terminal. If, for example 
you have used the terminal to debug your program (that is, locate and 
correct the errors), but you don't want to run the whole progras on the 
terminal, you can request a batch run, Or if you want a listing of your 
program and would rather use the line printer (which is faster) instead of 
the Selectric typewriter or CRT (Cathode Ray Tube), you should create a 
batch job. Example 21 illustrates how this can be done. 


Rule__ 37: To create a temporary 


cs file, you merely have to mention the 
#$get -tenp name. Thus, in this example -TEMP 


#READY. is created implicitly in the SGET 
#Snumber statement. 

# 1_$$signon myid * oscar'* 

# 2_sesane 

# 3_$$run *ftn par=source=p Rule_38: To run a batch job from a 
# 4_$$run -load terminal, copy a file, in this case 
# 5_$$signoff “TEMP, to *BATCH*, -TEMP must con- 
# 6_Sunnumber tain a complete batch job including 
#$list -temp SSIGNON and SSIGNOFF. A six-digit 
> 1 SSIGNON MYID * OSCAR® receipt number is typed which aust 
> 2 SESAME be presented at the Production Con= 
> 3 SRUN *FIN PAR=SOURCE=P trol Desk to collect the job (unless 
> 4 $RON ~LOAD it is delivered). If the same sign- 
> 5 $SIGNOFF on is used for both the batch job 


#END OF FILE 
#$copy “temp *batch* 
>*BATCH* ASSIGNED RECEIPT NUMBER 


and the present terminal session, 
the batch job will be run as soon as 
possible after the signoff at the 


603772 terminal. 

>*BATCH* 603772 RELEASED 

#$signoff 

#OFF AT 12:34.50 02-21-73 Rule __ 39: Note that when you 
#ELAPSED TIME 2.632 MIN. SSIGNOFF, file -TEMP is destroyed 
#CPU TIME USED 1.516 SEC. Since it is only a scratch file. 
#CPU STOR VMI tS PAGE-MIN This, however, is no problem since 
#WAIT STOR VMI «286 PAGE-ER. | *BATCH* already has all the informa~ 
#DRUM READS 51 ] tion it needs from -TEMP. If you 
#APPROX. COST OF THIS RUN IS §$.37}] expect to use this sequence of cons- 
#DISK STORAGE 15.9 PAGE-HR.] mands again and would like to have 


#APPROX. REMAINING BALANCE: $100.4 them saved, you should use a  per= 
nt Manent file instead of a scratch 


Example 21. file. 
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All that remains to be said is: 


ee 
{ $GoOD LUCK \ 
| $RUM TO CONSULTANTS IN ROOM 333, ASB 2.1 
re | 
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A_BRIEF_ OVERVIEW OF MTS 


ACCESS_TO_THE SYSTEM 


All access to MTS is controlled by the system itself from information 
supplied to it by the CDPC administrative staff. See Facilities and 
Services of WSU Computing and Data Processing Center for Academic Users 
(February 1973) for information on how to apply to use MTS. 


As its name iaplies, the Michigan Terminal System was designed for access 
froa remote terminals, although the system also has extensive facilities for 
processing batch jobs. 


Batch and terminal access differ from each other as little as possible. 
The command language is identical, and the same translators and utility 
programs are available in both modes, Batch, however, is usually inappro- 
priate for jobs requiring interaction between the user and the progran. 


Although some users need only batch access and others only terminal 
access, the majority of users use both: terminals for program development 
and debugging, and batch for bulk-data input and output, and production 
running (for non-interactive programs). 


Batch may be either local or reaote. Local batch is submitted and 
retrieved at the CDPC. The mechanics of this are described in the asaanuals 
titled Facilities and Services of HSU Computing and Data Processing Center 
for Academic Users (February 1973) and Introduction to SIS @ WSU (January 
1974); internal processing and options of interest to users submitting batch 
jobs are described in the section "Batch Usage of MTS". At the remote batch 
(often called Remote Job Entry, or RJE) station, batch card decks are read 
and printed output is produced from information transmitted via telephone 
lines to and from the Computing Center. The operational details of this 
remote station are described in "Batch Usage of MTS". 


Terminal access depends on the type of terainal being used. The 
following terminal types are currently supported by MTS. (This is not an 
exhaustive list; see "Conversational Usage of MTS" later in this volume.) 


Selectric typewriter terminals 

IBM 1050 (and 1056 Card Reader) 

Model 33 Teletype 

Model 35 Teletype 

Westinghouse 1600 Cathode Ray Terminal 


Any terminals compatible with the Selectric typewriter terminals or the 


Teletype (such as IBM 2741 and DURA) are also supported. All terminals are 
connected by means of the dial-up facilities of the telephone company. The 
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system is accessed through the MEMOREX Transmission Control Unit. Details 
may be found in the appropriate sections of the "MEMOREX 1270 Device 
Commands" in Volume 4. 


DATA_INPUT_AND_ OUTPUT 


Batch users may enter input data via punched cards and receive output via 
ptinted paper or punched cards. Magnetic tapes may be used by both batch 
and terminal users. Details on programming and usage of gwaagnetic tapes are 
found in "The Magnetic Tape User's Guide" in Volusze 4, 


GENERAL CONCEPTS 


User programs, system translators, and utility programs are all treated 
identically; they are just programs. The command "$RUN xx" is used to 
request execution of the object program contained in the file "xx". Thus, 
the comaand SRUN *FTN requests MTS to execute the FORTRAN compiler, and $SRUN 
OBJ requests MTS to execute the user's object module in the file OBJ. 


Leqical 1/0 Units 


Programs obtain data and produce output by rmeans of logical I/0 units. 
For example, a translator typically reads the source program from logical 
I7O unit SCARDS, produces listing output on logical unit SPRINT, and writes 
the translated object program on SPUNCH. When the user invokes a progran 
using the $RUN command, he specifies a file-or-device pase (FDname) to be 
attached to each of the logical units the program will use. For example, 


S$RON *WATFOR SCARDS=FYLA 
attaches file FYLA to SCARDS, so that WATFOR reads from FYLA which hopefully 


contains a source prograa. If a logical unit is not explicitly assigned, a 
default is usually taken. File-or-device names can be: 


file naszes FYLA 

device names >RDR1I 

pseudo-device names *SOURCE* Specifies the input card deck 
for batch, the keyboard for 
terainals. 

any of the above with PYLA (10,15) Specifies all lines in FPYLA 

line number ranges with line numbers in the 


range 10 through 15. 
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any of the above with FYLA@~TRIM Specifies no trimming of 
modifiers trailing blanks. 
or any combination of FYLA (10, 15) +FYLB¢Ca~TRIM (1, 1000) 


the above 
(called explicit 
concatenation) 


Details of the names that can be specified and their meanings are found in 
the section "Files and Devices", 


Prefix Characters 


When a user is at a terminal, a special character is printed as the first 
character of every line of output and as a first character on the line 
before waiting for input. This character is called the prefix character and 
identifies the system component or program which is writing the output line 
or waiting to read an input line. Each component of the system has a 
distinct character. For example, "#" in front of an input line means that 
the user is in MTS command mode. When a program is running, the prefix 
character is normally a blank. (The user may change this by calling the 
subroutine SETPFX. See the subroutine description in Volume 3.) A complete 
list of system prefix characters is given later in the section "Systen 
Command Language", 


Virtual Memory 


One of the primary constraints facing programmers has been the amount of 
addressable memory or main storage available. Addressable memory (sometines 
called core storage, for historical reasons), as opposed to auxiliary 
storage, refers to storage that can be addressed directly. In the past, 
when a program required more than the maximum main storage available, the 
“ping-pong” or “overlay" method was often used. Using this technique, the 
programmer divided his program into self-contained sections, each ssall 
‘ enough to fit into main storage. Each section was loaded and executed 
separately, and it was up to the programmer to control the order, loading, 
and linking of the sections. This was no simple task. 


The concept of virtual memory, iaplemented in the IBM 360/67, allows the 
user more addressable memory than is physically available. In effect, the 
system is doing the "ping-ponging" for the programmer and he does not have 
to worry about any of the details. The system breaks the program into 
sections called pages, “paging” in sections when they are needed and 
"paging" them out when they are no longer needed. 


Virtual memory is many times larger than actual physical memory and is 
divided into segments. A segment is 256 pages and a page is 4096 bytes 
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(characters). There are 1,048,576 bytes in one segment. Each user may use 
several (currently up to four) segments, besides the three segments which 
are shared by all users. These three segments contain the reentrant 
routines that are commonly used, such as the resident system, MTS, and the 
I/O routines. Great economy is achieved by keeping only one copy of each of 
these routines in memory instead of one for each user. 


The primary advantage of the virtual memory concept is apparent--each 
user has access to a very large address space. The system insures that when 
a page is needed, it is brought into main storage if it is not already 
present. In order to utilize the system efficiently, it is desirable to 
minimize the number of different pages needed in rapid succession. The 
following programming suggestions can reduce the amount of paging required. 


In FORTRAN, when indexing a large multi-dimensional array which requires 
more than one page, it is advisable to vary the left-most subscript most 
rapidly. This causes the array elements to be accessed in the order that 
FORTRAN stores thea. 


When searching a table, a linear search through one page is more 
efficient than a random search through several pages. When a table is 
larger than a page and has many pointers, it is better to use an index table 
to get directly to the proper page rather than to follow all the pointers in 
succession. 


NSTS_CONMAND LANGUAGE 


In order to use the computer, one must first get the attention of MTS and 
identify himself through the $SIGNON command. Once he has done this and NTS 
has agreed that he is a legitimate user, the IBM 360/67 is at his disposal. 


In this section, the commands are listed in their most common fora 
followed by a brief explanation of their function. Not every possible 
option and parameter is mentioned. A detailed explanation of the commands 
may be found in the section "System Command Language". 


As stated earlier, command lines start with a "S$" followed immediately by 
the command name or the command abbreviation. The "$" is required for batch 
runs but not necessarily for conversational runs. In a conversational 
interaction with MTS, the "$" for a command is not needed if (1) there is no 
line number at the front of the input line, and (2) automatic line nuabering 
is off or there is no currently active file in which to place data lines, 
Under these conditions, the command line may start with the comaand name or 
the command abbreviation. If these conditions do not hold, then the leading 
*$* is required on all MTS comands. Note that these restrictions 
essentially say that MTS attempts to interpret an input line as a command 
line, even without a leading "8", if it is not prepared to accept a data 
line from the user and if the user is in conversational rode. 
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A. 


Global_Control 


$SIGNON yyyy 


SS IGNOFF 
$SET 
$SINK xx 


SSOURCE xx 


Program Control 


SRUN xx 


S$LOAD xx 


SSTART 


SRESTART 


SUNLOAD 
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tells MTS that the user with ID "yyyy" wants to use 
the aachine. The password associated with the ID 
must be entered either with the $SIGNON command or 
on the following line. 


Signs the user off the machine and gives him a 
Summary of the cost of the run. 


is used to set various switches and variables in 
the systen. These control such functions as set- 
ting the user's password, automatic errordumping, 
the line number separator character, upper= and 
lower-case conversion, implicit concatenation, plus 
a few more esoteric switches. 


makes the pseudo-device *SINK* refer to the file or 
device "xx" instead of the printer (in batch mode) 
or the terminal on which the user is typing (in 
conversational mode). 


makes the pseudo-device *SOURCE* refer to the file 
or device "xx" instead of the card reader (in batch 
mode) or the terminal on which the user is typing 
(in conversational mode). 


tells MTS to load and execute the program in the 
file "xx". These files can be public, such as *FTN 
or *STATOUS, or private, such as MYPROGR or =LOAD. 


tells MTS to load but not execute the program in 
the file "xx". The program can then be displayed 
and/or altered. Execution can be started by the 
S$START command. 


starts the execution of a program which has already 
been loaded by a $LOAD command. 


restarts the program at the point of the last 
interrupt or at a specified location. S$SSTART and 
SRESTART are synonymous and may be used 
interchangeably. 


releases storage and devices from the previous 


SLOAD or $RUN. It is useful when the execution of 
a program did not terminate normally. 
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For_ Debugging 


SDEBUG xx 


$sDs 


SALTER xx yy 


SMODIFY 


SDISPLAY xx 


SHEXADD xx yy 


SHEXSUB xx yy 


SDUMP 


SERRORDUMP 


SCREATE xx 


SDESTROY xx 
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tells MTS to put the Symbolic Debugging Systen 
(SDS) in control. SDS has its own set of commands 
which allows the user to interactively debug his 
program. A listing of the important debug commands 
is given below. 


returns control to SDS from MTS. 


allows the user to change the contents of a general 
register, a floating point register, or a specified 
location in virtual menory. "yy" becomes the 
contents of “xx", 


is a synonym for SALTER. 


displays the contents of "xx", where "xx" may be a 
general register, floating-point register, or a 
specified region of virtual memory. 


prints out the hexadecinal sum of the hexadecinal 
numbers "xx" and "yy". 

prints out the hexadecimal difference between the 
hexadecimal numbers "xx" and "yy". 


prints out the contents of the general registers, 
floating-point registers, and all the virtual 
menory locations associated with the current job. 


provides a dump of all the registers and storage if 
the execution of a prograam terminates abnormally. 


This command is effective in batch sode only. 
(This is the same as $SET ERRORDUMP=ON.) 
creates a file named "xx". If it is not a 


temporary file (that is, if its name does not begin 
with a minus sign), it is retained until the 
creator destroys it. "xx" becoswes the currently 
active file. 


destroys the file named "xx" and returns the 
on disk to the pool of available storage. 


space 
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SEMPTY xx 


SCOPY xx TO yy 


$LIST xx 


SGET xx 


SRELEASE xx 


SNUMBER 


SUNNUMBER 


$EDIT xx 


SPERMIT xx 


Miscellaneous 


SCOMMENT 


$CALC exp 


SCONTROL xx yy 
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empties the contents of the file "xx" but retains 
its identity. Thus the file can be reused later. 


copies the contents of the file "xx" into the file 
"yy". Unless specified otherwise, the lines are 
numbered sequentially from 1 as they are entered in 
the new file regardless of their numbers in the old 
file. The old file is retained unaltered. 


lists (with line numbers) the contents of file "xx" 
on the line printer (batch mode) or the terminal 
(conversational mode). 


makes "xx" the currently active file. If "xx" is a 
private file, it must have been created previously. 
If “xx" is a temporary file and does not already 
exist, it will be implicitly created by this 
statement. 


releases the currently active file, dismounts a 
magnetic tape "xx", or releases a HASP pseudo= 
device "xx", 


tells MTS to automatically number the lines that 
follow as they are put in the currently active 
file. Unless otherwise specified, numbering starts 
with 1 and increments by 1. 


tells MTS to stop the automatic numbering which one 
presumably requested earlier by a SNUMBER command. 


tells MTS to put the EDITOR in charge. Like SDS, 
the EDITOR has its own set of commands which allow 
the editing of the file "xx". A listing of the 
EDITOR commands is given below. 


changes the access code of file "xx" to either 
allow or not allow other users access to file "xx", 


allows insertion of comments on output to the 
terminal or printer. 


evaluates the arithmetic expression "exp" and 
prints the result. 


sends the control command "yy" to the pseudo-device 
xx", 


A Brief Overview of MTS 41 


ETS Volume 1: MTS == The Systen 


April 1974 


SINQUIRE xx displays the current status of the batch job, an 
execution queue, a print queue, a punch queue, 
plotting jobs, OS batch jobs, UMMPS jobs, or other 
systea activity. 


SMOUNT xx mounts the pagnetic tape or MERIT network connec- 
tion "xx", 


$NET xx enters into the MERIT communications network systea 
for the connection "xx". 


THE_LINE FILE_EDITOR COMMAND LANGUAGE 


After the user has entered the command SEDIT xx, ATS turns control over 
to the MTS line file editor which is ready to accept commands concerning the 
editing of the file named "xx", 


A user editing a file may edit either by line number or by context. 


The editor maintains a current line pointer which is initially set to the 
first line of the file. Commands that require line nuaber specification aay 
refer to the line pointer or may explicitly mention the appropriate lines. 


This section gives a brief description of the command language understood 
by the file editor. For the complete description of the line file editor, 
see the "Edit Mode" description in the "System Command Language" section. 


A. Compands Which Move the Line Pointers 
LINE causes line "n" to become the current line. 
SCAN scans a specified area of the file for a particular 


string and sets the line pointer to the line 
containing the string. 


#n or n moves the line pointer forward "n* lines. 


-n : moves the line pointer backward "n" lines. 


Be. Copsands Which Change Characters within a Line 


ALTER allows the user to replace one string of characters 
with another in a specified line. 
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BLANK allows the user to blank out parts of a line 
selectively. 
OVERLAY allows the user to replace selected characters in 
the old line. 
SHIFT shifts characters right or left within a line and 
inserts blanks into vacated positions. 
C. Commands Which Change Entire Lines 


COPY ; copies specified lines (without deleting them) to 
another region of the same file. 

DELETE deletes specified lines from the file. 

INSERT allows the user to insert new lines into the file. 

REPLACE causes the lines in the specified range to be 


replaced by the given string. 


Commands to Get Out of EDIT Mode 
MTS returns control to MTS. To return to the editor, 


use the EDIT command. 


STOP causes the file editor to return control to MTS. 


Commands_Which Affect Editor Control 
EDIT xx tells the editor that a new file named "xx" is now 
to be edited. 


SET is used to change the values of a number of 
switches which govern the editing process. 


REGION /name allows the user to name subsections of a file with 
a region name "/name", for subsequent reference. 


XEC $name allows the user to store a sequence of editor 
commands as a program named "$name", 
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FP. Niscellaneous 

CHECKPOINT tells the editor to keep a copy of the file as it 
is at the time of this call so that it may be 
restored later, if necessary. 

RESTORE is used in conjunction with CHECKPOINT and tells 
the editor to restore the specified lines (or the 
whole file) to their condition at the time of the 
last CHECKPOINT command. 

EXPLAIN asks the editor to explain its entire operation, a 
particular command, or an error coanent. 

PRINT requests the editor to print out certain parts of 
the file. 

RENUMBER commands the editor to renumber the file, where the 
user can specify the starting number and increment. 

COLUMN specifies the column range that can be referenced 
by the commands ALTER, MATCH, SCAN, and SHIFT. 
Initially the range is from 1 to 255. 

DEBUG COMMAND LANGUAGE 


The Symbolic Debugging System (SDS) is a conversational program checkout 
facility which aids in the process of debugging programs from ai renote 
terainal. The MTS command S$DEBUG xx has the same format as the $RUN 
command. It tells MTS to load the program in file “xx" and then give 
control to SDS. Using the SDS command language, the programmer initiates 
execution of his program and monitors its flow by specifying breakpoints 
where instructions and data may be modified and displayed. 


The programmer may refer to locations in his prograg symbolically, by 
relative address, or by absolute (virtual or loaded) address. Symbolic 
referencing can be used only with those language processors which generate a 
symbol table with the object prograas they produce. (Currently, this 
includes the G-level 360 assembler and FORTRAN@G.) If the user has 
requested that SDS display the contents of a particular location--using any 
of the above three ways to name the location--SDS consults the syabol table, 
if there is one, to get the proper type and length of the location. If 
there is no symbol table, the contents are printed in hexadecimal in units 
of & bytes. , 


This section gives a brief description of the more conson commands 


available. For a complete description of all the debug commands, see the 
“Debug Node" description in the "System Command Language" section. 
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A. Setting and Clearing Breakpoints 

AT xx inserts a breakpoint in location "xx" of the 
program being debugged. When execution reaches 
location "xx", the SDS commands following the AT 
command are executed. 

END marks the end of a sequence of commands started by 
an AT command. 

BREAK xx inserts a breakpoint at location "xx", When the 
program being debugged attempts to execute the 
instruction at location "xx", control is given to 
SDS which then requests further commands from the 
user. 

CLEAN deletes all breakpoints set by the AT and/or BREAK 


RESTORE xx 


Control Commands 


RUN 


CONTINUE 


GOTO xx 


STEP na 


aTS 


sDdS 


STOP 


conmands. 


deletes the breakpoint "xx" or the most recently 
created breakpoint if "xx" is not specified. 


transfers control to the entry point of the prograr 
being debugged, thus starting execution. 


causes the program being debugged to continue 
execution after a breakpoint or an interrupt has 
occurred. 


transfers control to location "xx" of the prograr 
being debugged. 

allows the user to step through the 
instructions. 


next nn 


returns control to MTS. 
MTS $SDS command. 


To return to SDS, use the 


transfers control to SDS which then requests aore 
commands. This command is used with the AT 
command. 

stops SDS processing, unloads the user's program, 


and returns control to MTS. 
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The_Actual_ Debugging Comsands 

MODIFY xx yy changes the contents of location "xx" to contain 
i yy" = 

ATTRIBUTE yy prints out the attributes, such as length and 
address, of the symbol "yy". 

DISPLAY xx prints the contents of location "xx". 

HEXDISPLAY xx prints the contents of location "xx" in 
hexadecinal. 

SCAN xx yy scans through the region "xx" for the value "yy". 
If the search is successful, the location where it 
was found is printed. 

SYMBOL xx prints the sygbolic name of location "xx". 

DUMP prints a syrabolic dump of the user's prograa. 

Setting SDS_ Parameters 

SET allows the user to set various control parameters 
in SDS. These include the default length, scale 
and type attributes, the processing of program and 
attention interrupts and the processing of dynaa- 
ically loaded sections. 

RESET allows the user to reset the SDS control 
parareters. 

CSECT xx makes control section "xx" the current section. 

USING is used when the programs being debugged easploys 
DSECTs. The command provides addressability for 
DSECTs. 

Miscellaneous 

MAP produces a sap of all the sections in the prograr 


which were processed by SDS. 
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LANGUAGE TRANSLATORS 


MTS provides a wide variety of translators for assorted programming 
languages. This section gives a brief description of the languages 
available and mentions which public files contain the appropriate transla- 
tor. Volume 2 describes all public files containing the language transla- 
tors. These descriptions should be checked before actual usage is 
attenpted. 


Procedure-Oriented Languages 


ALGOL is a procedure-oriented language useful for numerical calculations. 
The processor is located in the public file *ALGOL. 


ALGOLW is a revised version of ALGOL. This is a revision of Stanford 
University's ALGOL W which was done by the University of Newcastle. 
This processor is in the file *ALGOLW. 


COBOL (Common Business Oriented Language) is a programming language 
suitable for commercial data processing work. The file *COBOL 
contains a version of the IBM ANS COBOL compiler. 


FORTRAN IV (Formula Translator) is a language used for solving problems 
which can be stated in mathematical terms. The IBM Gelevel FORTRAN 
compiler is available in the public file *FITN. The IBM H=-level 
FORTRAN compiler--which is slower and more expensive than the 
G-level compiler, but produces shorter object programs and better 
error commentse-can be found in the file *FORTRANH. 


PL/I (Programming Language J) is a programming language which is suitable 
for both scientific and business coaputations. The compiler is 
available in the file *PL1. 


SPL (Student Programming Language) is primarily a subset of PL/I and is 
useful for students in introductory courses. The compiler is 
available in the file *SPL. 


WATFOR (Waterloo FORTRAN) is a load-and=-go (compile-and-execute) FORTRAN 
compiler useful for running short debugging jobs in the FORTRAN 
language. The compiler has excellent compile-time and run-time 
diagnostics, but programs run under WATFOR execute more slowly than 
those run from object decks produced by the FORTRAN compiler. If 
the user intends to execute the program often, he is advised to 
debug the program using WATFOR and, after it is debugged, to obtain 
an object deck from *FTN. The WATFOR compiler is available in the 
files *WATFOR and *SWAT. (The version in *SWAT is for shorter 
programs.) 
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XPL is a language useful for writing compilers and can be found in the 
file *XPL. 
Agseablers 


TBM 360 Assenbler Language is a low-level (one step removed from sachine 
language) symbolic language. The IBM G-level Assembler is available 
in the file *ASMG. 


IBM 1130 and 1800 Assembler Language programs may be assembled by the 
assembler located in the file *1130ASM. 


PDP-x Assembler Language facilities are available for those programmers 
desiring object decks for use with Digital Equipment Corporation 
PDP-1, PDP-5, PDP-7, PDP-8, or PDP-9 machines. fhe file *1ASR has 
the asseabler for PDP-1 machines; file *8ASR has the assembler for 
PDP-5 and PDP-8 machines; the file *9ASR has the assembler for PDP-7 
and PDP-9 sachines. 


PL360 is an ALGOL-like translator which gives the source language pro- 
grammer mach of the power and flexibility of writing assembly code. 
The translator is available in the file *P1L360. 


STASS 360 (Student Assembler 360) is an assembler especially tailored for 
student use. It provides fast batch assembly and execution of small 
jobs with extensive error-checking at both assembly and execution 
time. This assembler can be found in the file *STASS360. 


interactive Lanquages 


APL (A Programming Language) is a conversational programming language 
which is best suited for probleas requiring extensive sanipulation 
of a small amount of data. It can be run from Selectric typewriter 
terminals and requires a special type ball for the terminal. APL is 
available in the file *APL. 


BASIC is an easy-to-use interactive language which operates in its own 
subsystenr,. Within BASIC one can do numerical calculations as well 
as simple MTS-like functions such as file manipulations. The BASIC 
system is located in the file *BASIC. A full description of BASIC 
is given in Volume 10. 


PIL (pittsburgh Interpretive Language) is an interactive, procedure- 
oriented language particularly designed for terminal use. The 
interpreter is available in the file *PIL. A newer version of PIL 
is documented in MTS Volume 12 and is located in the file CCAP:PIL2. 
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REDUCE 


is designed for general algebraic computations of interest to 
physicists and engineers. Its capabilities include: expansion and 
ordering of rational functions of polynomials, symbolic differentia=- 
tion, reduction of quotients of polynomials by cancellation of 
common factors, calculation of symbolic determinants, and calcula- 
tions of interest to high-energy physicists, including spin 1/2 and 
spin 1 algebra. The program is written in LISP and may be accessed 
by S$SOURCE *REDUCE2. 


List-_and String-Processing Languages 


LISP 


SLIP 


SNAP 


SNOBOL4Y 


UMIST 


*1 


is a list-processing language available in the file *LISP. 


{Symmetric List Processor) provides list-processing capabilities. 
MTS has provided these capabilities in the form of a library of 
FORTRAN-callable subroutines. The library is in *SLIP and must be 
concatenated to the object modules which contain the subroutine 
calls. 


is an English-like language designed for those persons who perforn 
text=processing tasks but desire minimal computer knowledge. The 
processor for SNAP is available in the file *SNAP. 


(String Qriented Symbolic Languages) is a symbol- (string~) manipu- 
lation language which is useful in language translation, prograa 
compilation, and combinatorial problemas. A compiler for SNOBOL4 is 
available in the file *SNOBOLS. The blocks version of SNOBOL4 has 
additional features, making it especially good for text layouts. 
This version may be found in the file *SNOBOLSB. A faster version 
of SNOBOLS may be found in *SPITBOL. 


(University of Michigan Interpretive String Translator) is an 
interactive text=processing language. It interprets strings of 
characters accepted one-at-a-time from the input device and prints 
the value of each string after processing. The translator can be 
found in the file *UMIST. 


is an IL-6 type language for processing list structures at the 
assembly language level. It is implemented in the form of macros 
callable from the 360 Assembler Language found in *ASMG. The macros 
are in the file *1. For details on the usage of this library, see 
the *1 public file description in Volume 2. 


Simulation Languages 


CSMP 


(Continuous System Modeling Program) is a simulation language 
specially designed for those simulation models which are expressed 
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as differential equations or as equivalent analog block diagrams. 
The translator is in the file CCAP:CSMPTRAN, the executor is in the 
file CCAP:CSMPEXEC, and the library to be concatenated at run time 
is in the file CCAP:CSMFLIB. 


GPSS (General purpose Siaulation System) is a program for conducting 
discrete event evaluations of systems, methods, processes, and 
designs. The main feature of GPSS is a simple flow chart language 
for describing the problem or system to be simulated. Once this 
description is read into GPSS, the program automatically perforas 
the simulation including the gathering of statistics. The results 
may be printed out automatically or under control of the user, who 
may wish to present them in a graphical format. The programa is 
available in the file CCAP:GPSS. 


SIMSCRIPT-ITI is a general progragming language that has features of 
particular interest for discrete event simulation problems; however, 
the language is rich enough to be used also in non-siaulation 
probleas. The compiler is awailable in the file CCAP:SIM2. The 
library to be concatenated at run time is in the file CCAP:SIMLIB. 


Statistica] Program Packages 


SPSS (Statistical Package for the Social Sciences) is an integrated set 
of programs for the description and statistical analysis of social 
science data. SPSS contains routines for the preparation and 
editing of data, for the calculation and display of frequency and 
joint frequency distributions, as well as a large number of 
parametric and non-parametric statistical procedures often used by 
social scientists. The program is available in the file CCAP:SPSS. 
Manuals describing its use are available at the WSU Bookstore. 


CONSTAT (CONsole STATistics) is a console-oriented (user prompting) statist- 
ical computing prograa. It sets up a data structure which is conaon 
to many statistical problems and provides a set of of subroutines to 
perfora statistical analyses on the data. The program is available 
in the file CCAP:CONSTAT. Documentation is available at the WSU 
Bookstore. 


OSIRIS (Qrganized Set of Integrated Routines for Investigation with Statis- 
tics) is a set of programs for the analysis of social science 
(especially survey) data. Data management includes generation of 
specially formatted files, and corrections and transformations of 
these files. The statistical part includes aultivariate and non- 
parametric analysis prograas. Manuals describing its use are 
available in the bookstore. 7 
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Information Retrieval 


BIRS (Basic Information Retrieval System) is a set of programs for the 
creation of data bases and for the retrieval and reporting of 
information extracted according to the user's specification. These 
reports may take the fora of printed indexes and catalogs. A search 
language permits file queries using standard logical operators. The 
program is available in the file CCAP:BIRS. Documentation is 
available at the WSU Bookstore. 


SERVICE FILES 


MTS provides a number of public files which can best be described as 
service or information files. The most useful of these are described in 
this section. : 


information about _a Particular ID Number 


SPUN *STATUS prints out all the statistics of the user SIGNON ID given 
on the SSIGNON command. The statistics include such items as the 
amount of money spent and remaining, the disk storage currently 
used and remaining, the number of terminal and batch jobs run, and 
so On. 

SRUN *CATALOG gives a listing of all the user's files currently defined. 


SRUN *FILESNIFF allows the user to get detailed information about the 
status of a particular private file. 


information about Activities of the Computing and Data Processing Center 


SCOPY HELP: DELIVERY lists a file of all the CDPC delivery codes. 


SCOPY HELP:DIRECTORY lists a file of references to other information 
sources organized by subject. 


SCOPY HELP:HELP lists a file of names of people who are willing and able 
to provide help in the use of some (or all) aspects of the 
computing facilities. 


SCOPY HELP: RATES lists a file of charges for various CDPC services. 
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$cOPY HELP: HOURS lists a file containing the schedule of various CDPC 
services, 


$COPY HELP: NEWS lists a file of current news from the CDPC. Entries are 
listed in reverse chronological order. 


Two programs exist which are useful in formatting and editing docuszents. 
The program in the file *FmT is good for short documents. TEXT3€0, good for 
loager documents, has several components, each residing in the separate 
files *PRESCAN, *FMAINT, *BLDLIN, *PLAOUT, *POSTPR and *PRINT. ; 


Information on these progrags is found in Volume 5. 
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INTRODUCTION TO THE EDITOR 


The context editor is a useful tool for either changing the contents of a 
file or searching a file for certain items. Entire lines can be inserted, 
deleted, or replaced, or changes can be made to only part of a line. 


In the following discussion, assume that the file PROG is a line file 
which contains a rather botched program. The examples are given exactly as 
they would appear on a terminal. Input from the user is in lower case; 
output from the editor is in upper case. 


To enter edit mode from MTS command mode, use the EDIT command specifying 
the file to be edited as the parameter: 


#edit prog 


Note the change in prefix characters above. Before entering the EDIT 
command, the prefix character was "#" indicating that we were in MTS command 
mode. Now the prefix character is ":" indicating that we are now in edit 
mode and communicating with the editor. 


Editor commands begin with an edit command name. For example, to print 
the first line of the file: 


: 1 DIMENSION DATA (50) 


The "1" at the front of the line is the line number of that line in the 
file. 


Modifiers may be appended to the command name to change the behavior of 
the command. For example, to print the first line without the line number, 
append the "@NL" modifier (all modifiers start with an "@";: 


:printanl 
$ DIMENSION DATA (50) 


Command names can be abbreviated. In all cases, the first three letters 
are enough. Sometimes only one or two letters is enough. For example: 


oe 68 oe 
md 


DIMENSION DATA (50) 
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Uniess one is certain that a given abbreviation represents the command 
wanted, rather than another conmand, it is wise to use the full name. All 
further examples use the full command nane. 


The first parameter on any edit command that refers to the file specifies 
what line or lines of the file the command is to work on. If this parameter 
ig omitted, only the current line is used (except for two commands which 
search the file: SCAN and MATCH). Thus, in the above PRINT exaaple, the 
current line (which was initially set to be the first line of the file) was 
used. To specify a different line, include the line number, for exaaple: 


sprint 3 
+ 3 REAL MEAN 


One number, as above, means a Single line. To specify a range of lines, 
give the beginning and ending line numbers of the range: 


tprint 3 5 

: 3 REAL MEAN 

$ 4 WRITE (6,100) 

2 5 100 FORMAT(* ENTER NUMBER OF DATA POINTS ') 


Three special symbols can be used in place of a line nuaber: 


*L represents the number of the last line in the file 
*P represents the number of the first line in the file 
* represents the nuaber of the current line 


Por example to print the last line specify: 


sprint *1 
: 28 END 


To perform an operation on all lines of the file, the symbol "/FILE" may be 
used to represent the line number range that covers the entire file. 


In order to develop exaaples of editor usage, a copy of the original file 
is needed: 
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print /file 


3 1 DIMENSION DATA(50) 

3 2 COMMON DATA,N 

MH 3 REAL MEAN 

H 4 WRITE (6,100) 

3 5 100 FORMAT(* ENTEF NUMBER OF DATA POINTS*) 
$ 6 READ (5,101) N 

3 7 101 FORMAT (13 

: 8 WRITE (6,102) 

3 9 102 FOR. MAT (* ENTER DATA POINTS'*) 
: 10 READ (5,103) (DATA (I) ,-1=1,N) 

: 11 103 FORMAT (6F3. 2) 

$ 12 CALL CALC (MEAN,STD) 

$ 13 WRITE (6,109) NEA 

: 14 WRITE (6,104) MEAN,S 

3 15 104 FORMAT(* MEAN=",F8.4," STD="F8,4) 
: 16 END 

3 17 SUBROUTINE CALC (MEAN,STD) 

H 18 DIMENSION DATA(50) 

+4 19 COMMON DATA,N 

3 20 REAL MEAN, MEAN2 

3 21 po 10 I=1,N 

: 22 X = X+DATA (TI) 

: 23 10 Y¥ = Y+#DATA (I) *2 

: 24 MEAN = X/N 

: 25 MEAN2 = Y/N-MEAN**2 

3 26 STD = SQRT (MEAN2) 

3 27 RETURN 

3 28 END 


The remainder of this section is an explanation of how to fix up the file 
(or at least improve its condition). 


There are two basic methods by which one can use the editor. One method 
is by line number, In this method one needs a listing of the file with the 
line numbers, and then the editing is done by explicitly specifying the line 
nuaber. Since we have the listing of the file, this is the method we used 
in this introduction. The other aethod is by context. In that method one 
uses the SCAN and MATCH commands which search the file for the lines to be 
changed. That method is often used, for example, when one discovers that he 
has used both the name SEAN and the name AVER for the same thing, and he 
wants to go through the file change all occurrences of AVER to MEAN. 


DELETE, INSERT and REPLACE are commands that work on an entire line as 
opposed to altering part of a line. 


The DELETE command deletes either a single line or a range of lines. It 
is used in the same manner as the PRINT command. In the file PROG, note 
that line 13 is extraneous and should be deleted. 


sdelete 13 
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However, it is very easy to think 13 while actually typing "23", and 
consequently, the wrong line is deleted. A safer procedure would be to set 
the value of the current line to the line number of the line to be deleted. 
The editor then prints the current line. After checking that it is correct, 
the DELETE command is given without a parameter to delete the current line. 


tline 13 
: 13 WRITE (6,104) NEA 
sdelete 


e 
° 


The INSERT command is used to insert a line or group of lines in between 
existing lines of the file. INSERT never replaces or moves existing lines. 
If there is no “line nuaber roogz" to insert another line, because the two 
existing line nuabers differ by only .001, the comment "NO ROOM FOR FURTHER 
INSERTION" is given and it is up to the user to renusber the file or move 
lines around to open up space. 


There are two foras for the INSERT command. To insert only one line, 
specify it as a string on the command. To specify a string, give a 
delimiter, followed by the characters of the string, and terminate with the 
sane delimiter. The delimiter cannot be a letter or a digit and cannot 
appear in the characters of the string itself. For purposes of this 
introduction "3", ":", and "€#" are used because they are legal, because they 
do not usually appear in FORTRAN programas, and because at least one of then 
is a convenient lower-case character on most terminals. (On Teletypes, ":" 
and ":" are lower case; on Selectric typewriter terminals, "“#" is lower 
case.) Other characters are legal; see the "Edit Mode* description for 
details. 


The line number specified in the INSERT command specifies the line after 
which the new line or lines are to be inserted. If no number is specified, 
the new line or lines are inserted between the current line (as specified by 
the last LINE command) and the following line. Thus, to insert a "GO TO 1" 
statement before the END statement of the main programa, specify: 


tinsert 15 ; go to 1; 
7 15.25 Go TO 1 


Or use the safer procedure and set the current line to 15, check to see that 
it is the the right line, and then insert after line 15: 


sline 15 

3 15 104 FORMAT (* MEAN=',F8.4," STD=",F8.4) 
sinsert # go to 1# 

3 15.25 Go TO 1 


Note that in both cases the insertion is verified by printing the new line 
contents. Although this verification can be suppressed, it is strongly 
suggested that it be left on and the line be inspected to verify that the 
correct insertion was made. 
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To insert more than one line use the second form of the INSERT command. 
By leaving off the string parameter when specifying an INSERT command, the 
editor enters "fast-insert" mode in which the editor reads lines from the 
terminal to be inserted into the file. To leave "fasteinsert" mode, enter a 
null line or an end-of-file condition. Thus, to initialize the variables Xx 
and Y in the subroutine CALC in our file, specify: 


tinsert 20 

? x = 0.0 
? y = 0.0 
? 


Or else specify: 


tline 20 

: 20 REAL MEAN, MEAN2 
tinsert 

? x = 0.0 

? y = 0.0 

? 


Note that the editor switches the prefix character to a "?" to indicate 
that all lines entered are going into the file. It is a common mistake to 
enter "fast-insert" mode, enter the lines wanted, forget about leaving - 
“fast-insert" mode, and then to enter an edit command which is promptly 
inserted into the file. Watch the prefix character! 


The REPLACE command replaces one line with a new line which is supplied 
in one of two forms. The first is exactly like the first form of the INSERT 
command, where the new line is specified as a string. Thus, line 7 is fixed 
by replacing the whole line. (This is not the recommended way to fix it <= 
later a better method is demonstrated.) 


sreplace 7 # 101 format (i3)# 
: 7 101 FORMAT (I3) 
Or else: 
sline 7 
7 101 FORMAT(I3 


replace ; 101 format (i3); 
7 101 FORMAT (13) 


For the second form of the REPLACE command, if the new line is not specified 
as a string on the command, the editor prints the 01d contents of the line 
and then prompts for the new contents: 


:replace 7 


: 101 FORMAT (I3 
?: 101 format(i3) 
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101 FORMAT (I3) 


oo 80 
~d 


Now consider the commands that change parts of lines. The most important 
is the CHANGE command. The CHANGE command takes two strings as parameters. 
It searches the line (or range of lines) specified for the first string and 
changes the first occurrence found to the second string. The two strings 
are specified using three delimiters as follows: 


delimiter string deliniter string2 deliaiter 


Thus, in the file PROG, to change the incorrect variable specified in line 
14 from S to STD, specify: 


schange 14 #s#std# 

: 14 WRITE (6,104) MEAN,STD 
Or else: 

tline 14 

H 14 WRITE (6,108) MBEAN,S 

schange #s#std# 

4 14 WRITE (6,104) MEAN,STD 


By saking the second string a null string (no characters in it), it is 
possible to delete the characters specified by the first string. Thus, to 
delete the extraneous period in line 9, specify: 


tline 9 

3 9 102 FOR.MAT(" ENTER DATA POINTS*) 
schange #.## 

: 9 103 FPORMAT(' ENTER DATA POINTS') 


Since the second string can be of different length than the first, 
missing characters can be added to the line by specifying in the first 
string enough characters to identify where the missing characters are to go, 
and then make the second string the same as the first plus the missing 
characters. Thus, going back to line 7, to add a right parenthesis after 
the 3, specify: 


sline 7 

4 7 1010 «=~FORMAT(i3 

schange #3 #3) # 
7 


101 PORMAT(I3) 


Watch carefully to make sure the change made was the change intended. It is 
very easy to not specify enough characters so that the first occurrence of 
the characters is not those actually changed. Consider line 11: 


zline 11 
: 11 103 FORMAT (6F3. 2) 
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The format field width should be 5, not 3. If the change command is: 


schange #3#5% 
: 11 105 FORMAT (6F3. 2) 


The statement label is changed instead. The following command puts it back. 


schange #5#3# 
7 11 103 FORMAT (6F3.2) 


Now if one more character (either the one to the left or the right of the 
"3") is specified, there are enough characters to identify the correct "3". 


schange #3. #5. # 
: 11 103 FORMAT (6F5. 2) 


Another way to solve this problea is to restrict the part of the line 
which the CHANGE command searches. The CHANGE command only searches between 
two column pointers which are normally set to column 1 and 255. We could 
use the COLUMN command to set the left column pointer to column 16, make the 
change, and then set it back: 


scolumn 16 

schange #3 #5# 

: 11 103 FORMAT (6F5.2) 
scolumn 


Other commands are also affected by the column pointer; see the "Edit Mode" 
description for details. 


If all occurrences of the first string are to be changed to the second 
string throughout the line or lines specified, the "@A" modifier can be 
used. Thus, to change the iteration variable I to J in the READ statement 
of line 10, specify: 


sline 10 

: 10 READ (5,103) (DATA (I) ,1=1,N) 
schange@a 3134; 

: 10 READ (5,103) (DATA (J) ,r=1,N) 
: 10 READ (5,103) (DATA(J) ,J=1,N) 


Note that every replacement is verified. 


If the same change is to be made several times, the strings need not be 
specified for the second and succeeding times. If the strings are not 
specified on a CHANGE command, the last specified strings are used. Thus, 
after changing I to J in the above example, to change I to J. in the DO Loop 
of the CALC subroutine, simply specify the command and the line number 
range: 
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schange@a 21 23 


: 21 DO 10 J=1,N 
H 22 X = X¢DATA (J) 
3 23 10 ¥ = Y#DATA (J) *2 


The OVERLAY command is often used to add nissing items such as statement 
labels to a line. The OVERLAY command is specified exactly like the REPLACE 
command, but instead of replacing the line with the string given, it instead 
overlays the line with the non-blank characters of the string. Thus, to 
enter the missing statement label "1" on line 4, specify: 


line 4 

 & WRITE (6,100) 
overlay #1 # 

a) 1 WRITE (6,100) 


eo 8 08 ga 06 


Or else use the second form and be prompted for the overlay: 


zoverlay 4 

: WRITE (6,100) 

21 

4 1 WRITE (6,100) 


The editor is often ased to search for iteas in a file, as well as to 
change the file. Two commands, SCAN and MATCH, are used for searching. 
Both take a string to search as a parameter. 


The SCAN command searches for the first occurrence of the specified 
string anywhere in the line range specified. If no line or line range is 
specified, it starts at the current line and searches to the end of the 
file. If it finds the string, it sets the current line to the line where it 
found the string: 


sscan /file #taean# 
: 3 REAL MEAN 


To find all occurrences of a string, append the "8A" aodifier to the command 
name: 


sscan@a /file #mean2# 

H 20 REAL MEAN,MEAN2 

: 25 MEAN2 = Y/N-MEAN**2 
3 26 STD = SQRT (MEAN2) 


The MATCH command is the same as the SCAN command except that instead of 
searching for the string anywhere in the line, it requires the first 
character to match at the left column pointer position, the second character 
at the next coluan position, and so on. In other words, the searching 
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process is anchored by the left column pointer. Thus, to find all REAL 
declarations in the file, specify: 


:column 7 

smatchda /file #real# 

Hy REAL MEAN 

: 20 REAL MEAN, MEAN2 


Another difference between the MATCH and SCAN commands is that in the 
comparison process by MATCH, any blank characters in the string specified 
are considered as “arbitrary" and match any character in the file. Thus, 
the string * 0 M" matches both the COMMON and FORMAT statements: 


scolunmn 7 

smatch@a /file # o mt 

3 2 COMMON DATA,M 

3 5 100 FORMAT(* ENTER NUMBER OF DATA POINTS') 
3 7 101 FORMAT (13) 

3 9 102 FORMAT(® ENTER DATA POINTS') 

: 11 103 FORMAT (6F5. 2) 

H 15 104 FORMAT(* MEAN=",F8.4,' STD=',F8.4) 

b4 19 COMMON TATA,N 


In setting the current line in a file in all of the above examples, the 
LINE command sets the current line to a specific line number in the file. 
It is also possible to move relative to the current line by means of a 
command whose "name" is an integer representing the number of lines to move. 
Thus, the command "4" moves to the next line, "2" moves to the second line 
past the current line, and so on. By making the number negative we can move 
backward; "-1" moves to the preceding line. For example: 


sline 15 

: 15 104 FORMAT(* MEAN=",FS8.u,° STD=' ,F8.4) 
21 

: 15.25 GO TO 1 

272 

: 14 WRITE (6,104) MEAN,STD 


Finally, to return from the editor to MTS command mode, use the MTS 
command: ; 


suts 
# 


At this point, we have covered the basic commands for using the editor, 
and these should be enough for most simple editing. However, only about a 
dozen of the more than thirty commands available and only two of the 
modifiers available have been discussed, not to mention the many other 


features. The "Edit Mode" description should be consulted for the complete 
description of the editor. 
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INTRODUCTION TO DEBUG MODE FOR FORTRAN 


The Symbolic Debugging System (SDS) is a conversational facility for 
testing and debugging programs. This facility was originally provided for 
assembly language programs, but it has now been extended to include FORTRAN 
programs. Using SDS, the user may initiate the execution of a program and 
monitor its performance by displaying or modifying variables at strategic 
points in the program. This section provides a brief introduction to the 
debug mode command language for FORTRAN users. A small sample FORTRAN 
program is given to illustrate the use of SDS. The complete description of 
SDS is given in the "Debug Mode" section of this volume. 


Figure 1 is a sample program to compute the mean and standard deviation 
of an array of real numbers. The program consists of three sections: the 
main program MAIN which reads in the data values and prints the final 
results, the subroutine CALC which computes the desired quantities, and a 
blank=-named COMMON section which contains the data array. In FORTRAN, the 
main program always has the name MAIN unless it is explicitly specified 
otherwise during the compilation. 


This program is compiled by the FORTRAN G compiler in *FTN using the MTS 
command 


SRUN *FTN PAR=SOURCE=MEANPROG, LOAD=MEAN,TEST 


The source for the program is read from the file MEANPROG and the compiled 
object module is written into the file MEAN. The TEST parameter must be 
specified when use of SDS is expected in order to have the FORTRAN compiler 
produce symbol table records in the object module. These symbol table 
records are used by SDS and are necessary to enable the user to debug his 
program symbolically. 


The most common method of invoking SDS for debugging this sample program 
is with the MTS command 


SDEBUG MEAN 


The DEBUG command is the same as the MTS RUN command in the manner in which 
logical I/O units and the parameter field are specified. Here it is assumed 
that the program uses logical I/0 unit 5 for reading the input data and 
logical I/O unit 6 for printing the output results. For the present purpose 
of debugging this program interactively, all input test data is entered fron 
the terminal (*SOURCE*) and all output results are printed on the terminal 
(*SINK*). If the user wishes to assign these units to files, he may specify 
them on the DEBUG command, for example, 


SDEBUG MEAN S=INPUTFILE 6=OUTPUTYILE 
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SDS signals its readiness to accept a command by printing the prefix 
character "+" in column one. This prefix character precedes all SDS 
messages and diagnostics. 

When the program has been successfully loaded, the nessage 


+READY 
+ 


is printed, at which point SDS is ready to accept its first debug command. 


0001 DIMENSION DATA (50) 

0002 COSHON DATA,N 

0003 REAL MEAN 

0004 1 WRITE (6,100) 

0005 100 FORMAT (* ENTER NUMBER OF DATA POINTS') 
0006 READ (5,101) NW 

0007 101 PORMAT (13) 

0008 WRITE (6,102) 

0009 102 FORMAT(" ENTER DATA POINTS") 
0010 READ(5,103) (DATA(I) ,I=1,N) 
0011 103 FORMAT (6F5.2) 

0012 CALL CALC (MEAN,STD) 

0013 WRITE(6,104) MEAN,STD 

0014 10% FORMAT (* MEAN=',F8.4,° STD=",PF8. 4) 
0015 GOTO 1 

0016 END 

0001 SUBROUTINE CALC (MEAN,STD) 
0002 DIMENSION DATA (50) 

0003 COMMON DATA,N 

0004 ; REAL MEAN, MEAN2 

0005 X = 0.90 

0006 Y = 0.0 

0007 DO 10 I=1,N 

0008 X = X¢DATA (T) 

0009 10 ¥ = Y¢DATA (I) *2 

0010 MEAN = X/N 

0011 MEAN2 = Y/N-MEAN**2 

0012 STD = SQRT (MEAN2) 

0013 RETORN 

0014 END 


Figure 1. Sample Prograr 
Pigure 2 gives the sample output from a sequence of cormands used to 


debug the prograrm. Input froa the user is given in the lower case and 
output from SDS and the programs is given in the upper case. 


6& Introduction to Debug Mode in FORTRAN 


April 1974 


#debug mean 
+READY 
+run 


ENTER NUMBER OF DATA POINTS 
2 


ENTER DATA POINTS 
4.0 4.0 


SORT ARGUMENT NEGATIVE 
+CALL TO "MTS* 
+READY 
+csect calc 
+break is#5 is#12 
+DONE. 
+run 

ENTER NUMBER OF DATA 

2 

ENTER DATA POINTS 

4.0 4.0 
+ "IS#5" #** BREAKPOINT 
+READY 
+display 
+ wy Is 
+csect * 
+DONE. 
+display 
+N 'F 
+ DATA(1) 
+ DATA (2) 
+continue 
+ "IS#12" *** BREAKPOINT 
+READY 
+display mean mean2 
+ "MEAN" IS MULTIPLY@-DEFINED. 


n data(1) data (2) 
+2 


te 
TS 


4.0000000 
40000000 


+ MEAN "E* 0.25000000E+00 
+ MEAN2 ‘'E" =8.0000000 
+csect calc 
+DONE. 
+display mean 
+ MEAN ‘'E* 4.0000000 
+modify mean2 '0.0* 
+ MEAN2 ‘ES WAS -8.0000000 
+continue 
MEAN= 4.0000 STD= 0.0 
ENTER NUMBER OF DATA POINTS 
S$endfile 
#USER PROGRAM RETURN 
+READY 
+stop 
# 
Figure 2. 


POINTS 
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n 
NOT DEFINED IN THIS SECTION. 


DEFINITION USED FROM SECTION MAIN 


NOW 0.0E+00 


Sample Output 
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Since most users are incurable optimists when it comes to running a 
p®ogram for the first tise, the RUN debug command is given to determine what 
the program does on the first try. The comments "ENTER NUMBER OF DATA 
POINTS" and “ENTER DATA POINTS" are produced by the program, and therefore 
these two lines in the sample output do not start with the "+" prefix 
character. The program requires as a response an integer N of format 13 
giving the number of data points to be used in the progran. The input 
péints are read into the array DATA which is of format 6F5.2. 


A very simple set of test data is chosen for the first run. The size of 
the data set is 2 and consists of the points 4.0 and 4.0. This data set, 
uging a simple sental calculation, yields the results of 4.0 for the mean 
and 0.0 for the standard deviation. In choosing a test data set, it is wise 
td choose data which give an obvious and simple answer so that most errors 
in the program are readily apparent. 


After the program is run, the comment "SQRT ARGUMENT NEGATIVE" appears, 
indicating that an erroneous call to the SQRT library subroutine was made in 
the CALC subrottine. The FORTRAN library has produced the message indicat- 
i8tg that the value of the variable HEAN2 was negative. SDS intercepted the 
FORTRAN library's return to MTS and returned control to debug mode. 
WRenever any type of abnormal condition occurs during the execution of the 
pfogram, such as a progfarm interrupt or attention interrupt, SDS steps in 
and returns control to debug command aode. This also happens when a user's 
p¥ogram calls the resident system subroutines SYSTEM, ATS, or ERROR. 


At this point, if the user has a serially-reusable program, he may rerun 
his program and monitor its performance more closely. For a program to be 
sérially reusable, it must be capable of being rerun several times without 
béing reloaded. All locations which contain constant values which are 
changed by the program must be initialized by the program during execution. 
For example, a program containing the statenents 


DATA 1/3/ 
K= 1 


Tt 6 


wéuld not be reusable, since I would not be re-initialized to a value of 3; 
bet a programs containing 


I=3 
K =I. 
I = 6 


would be reusable, since I is set to 3 each time the program is used. In 
géneral, serially-reusable programs are easier to debug with SDS than are 
nén«serially-reusable programs, since they can be rerun several tines 
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without being reloaded. If the program were not serially-reusable, then the 
user would have to reload the program again using the $DEBUG command. 


As an aid to monitoring the execution of the program, SDS provides the 
capability of setting breakpoints. When a breakpoint is encountered during 
execution of the program, execution is stopped, and control is returned to 
debug mode. The instruction at which the breakpoint is set has not yet been 
executed when execution is stopped. 

The BREAK command may be used to set breakpoints by specifying the 
statement numbers at which execution is to be _ stopped. To refer to 
statement numbers in FORTRAN programs, a prefix must be used to distinguish 
the type of statement number being given. A "#" must prefix the statement 
number if it is an external (user-defined) statement number; for example, 


BREAK #10 


sets a breakpoint at the user-defined statement number 10. An "Is#" must 
prefix the statement number if it is an internal (source-listing) statement 
number; for example, 


BREAK IS#10 


sets a breakpoint at the source-listing statement 10. Only those statement 
numbers which define executable FORTRAN statements may be used. An 
executable statement is defined as a statement which is from one of the 
following categories: 


(1) Assignment statements 
(2) Control statements 
(3) I/0 statements 


All others, such as DIMENSION, REAL, INTEGER, DATA, COMMON, SUBROUTINE, 
FUNCTION, ENTRY, and FORMAT statements are not executable. Both internal 
and external statement numbers must be specified without leading zeros. 


Since a program may consist of a aain program and several subroutines and 
common sections, there must be a method for determining to which section 
statement numbers and other symbols refer. This may be done in two ways. 


The CSECT command may be used to globally restrict all statement numbers 
and symbols to a specified section. In the sample output, the command 
sequence 


CSECT CALC 
BREAK IS#5 Is#12 


is used to set breakpoints at statements 5 and 12 of the subroutine CALC. 
If cCSECT CALC had not been given, then the first occurrence of IS#5 and 
IS#12 would be used. In this case, IS#12 would be in the section MAIN and 
IS#5 would be in the subroutine CALC since IS#5 is a FORMAT statement in 
MAIN. The command 
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CSECT * 


may be used to restore the searching of all sections. If the CSECT command 
has not been given, SDS searches all sections for statement numbers or 
vatiable names and uses the first definition encountered. 


The ac keyword wodifier may be used to Iocally restrict a symbol to a 
specified . section. The @C sodifier applies only to the symbol to which it 
isi appended and overrides any global restrictions set by the CSECT command. 
In the sample run, the command 


BREAK IS#S IS#12@C=CALC 


also could have been used to set the breakpoints. The modifier @C=CALC 
restricts IS#12 to the subroutine CALC. @C=CALC is not needed for IS#5 
Since the only valid definition of IS#5 is in CALC. 


The setting of breakpoints at the internal statements 5 and 12 of CALC 
was chosen so as to allow a closer inspection of the program near the area 
where the error was indicated. At statement 5, the input data may be 
examined before any actual calculations are sade. At statement 12, the 
argument to the SQRT call may be examined. 


After the breakpoints are set, the program is rerun. When the breakpoint 
at IS#5 is reached, execution is stopped and the nessage 


"ISS" eek BREAKPOINT 
is printed. At this point, the user may enter another debug command. 


The DISPLAY command may be used to display variable locations in the 
program. Scalar variables are displayed by giving the variable name; for 
example, 


DISPLAY MEAN 


displays the contents of the variable MEAN converted according to its type 
and length. In this case, MEAN is a fullword real variable and its value is 
printed as 


MEAN ‘E® 0.2500000+£E00 


The code E indicates that the variable is real. The codes for FORTRAN 
variables are: 


Real (exponential or floating-point) 
Integer (fixed-point) 

Logical 

Couplex 

Hexadecinal 

Tnustruction 


4 > ce ott fg td 
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Array variables are displayed by giving the array name and its subscripts 
in the same manner as in the FORTRAN program; for example, 


DISPLAY DATA(1) 


displays the contents of the first element in the array DATA. 


To display a variable which is in a blank=-named common section, the @c 
nodifier (or CSECT command) may be used with the name BLANK to specify the 
section. In the sample program, the array DATA is in the blank-named comaon 
section. 


DISPLAY DATA (1) @C=BLANK 
could have been used. Simply using 
DISPLAY DATA(1) 


would not have worked if the CSECT * command had not been given first. 
Instead, an error message would be printed indicating that the symbol was 
undefined. 


If all sections are open for searching, and if a symbol is used in more 
than one section (or subroutine), then SDS displays the first occurrence of 
that symbol and issues a warning message. In the example, 


DISPLAY MEAN MEAN2 


produced a warning message for MEAN since MFAN is defined in both the 
sections MAIN and CALC. 


After the breakpoint at IS#5 has been reached, the next step is to 
display some of the input data values for the program to determine whether 
or not everything seems to be in reasonable order. The values of 2 for N 
and 4.0 for DATA(1) and DATA(2) indicate that the input data was correctly 
entered. 


A CONTINUE command may then be given to resume execution of the progran. 
After the breakpoint at IS#12 is reached, the user can again check the 
progress of the program. Displaying MEAN and MEAN2, it is discovered that 
the values are 4.0 and -8.0, respectively. A quick arithmetic check using 
the appropriate formulas 

MEAN = (DATA (1)+DATA (2))/N 
and 
MEAN2 = (DATA (1) 2+DATA (2) 2) /NoMEAN2 


yields the values 4.0 and 0.0, respectively. Hence, the value °-8.0 is in 
error. 
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Looking back over the sasgple program, the user can see that this error 
was introduced in statement 9 of CALC. That statement should read 


10 Y = Y+#DATA (I) **2 


Since it is not possible to recompile the program in SDS, the best that 
can be done at this point is to modify MEAN2 to contain the correct value, 
The MODIFY command may be used to do this. The first parameter for this 
coamand gives the name of the variable to be modified. The second parameter 
gives the value to be used in the modification; the value aust be enclosed 
in primes, for example, 


MODIFY MEAN2 '0.0° 


The value for MEAN2 is now sodified to 0.0, and execution of the progrars 
may be resumed to determine if the remainder of the program seems to be 
correct. This time, the correct values for the test data are printed by the 
prograa. 


Instead of entering a second set of test data, the user probably wants to 
recompile the program to correct the error in CALC. To terminate the 
prograa, the user enters a S$ENDFILE (or its equivalent). SDS intercepts the 
termination of the program and returns control to debug mode. fhe STOP 
command may be then used to return control to MTS. 

The user may use the RESTORE and CLEAN commands to remove breakpoints 
from the program that were set by the BREAK command. The RESTORE command 
removes a specified breakpoint. For example, 

RESTORE IS#12 


removes the breakpoint set at statement 12 in CALC. The CLEAN command 
removes all breakpoints that are set in the progran. 


Multi-dimensioned arrays are specified in the same manner as linear 
arrays. For example, the third element in the array specified by the 
FORTRAN source statenent 

DIMENSION ALPHA (10,10) 
may be displayed by 
DISPLAY ALPHA(3, 1) 


A sequence of elements of an array may be displayed using the block 


' notation format. For example, to display the first ten elements of ALPHA, 


the user may specify 
DISPLAY ALPHA(1,1)... (10,1) 
The user should note that in FORTRAN programs, arrays are stored in 


ascending locations with the first subscript increasing the sost rapidly and 
the last subscript the least rapidly. 
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Arrays may also be displayed using symbolic subscripts. If, in the 
FORTRAN program, the variables I and J have the values 2 and 3, respective- 
ly, then 


DISPLAY ALPHA (I,J) 
displays the element ALPHA(2,3). 
Arguments to FORTRAN subroutines may be one of two types: 


(1) reference by value, or 
(2) reference by location. 


When an argument is passed as a reference by value, the actual value of 
the variable is passed by the calling program to the subroutine. Therefore, 
a copy of that variable is in both the calling program and the subroutine. 
Scalar arguments are normally passed in this manner. The subroutine uses 
its copy of the argument for any calculations done. Upon the return of the 
subroutine to the calling program, the argument is passed back to the 
calling program and its copy is updated. Therefore, when displaying an 
argument of this type with SDS, it is important to keep in mind where the 
variable is located and when it is displayed. 


When an argument is passed as a reference by location, only the location 
of the argument is passed by the calling program to the subroutine. 
Therefore, only one copy -of the argument exists and it is located in the 
calling program. Array arguments are always passed in this manner. The 
subroutine uses the array locations in the calling program for its 
calculations. When displaying an argument of this type, either the variable 
name from the calling program or the variable name from the subroutine may 
be used. Both refer to the same argument. 


Most debug commands may be given in an abbreviated format. The nininua 
abbreviations that may be used are underlined. 


BREAK MODIFY 
CLEAN RESTORE 
CONTINUE RUN 
CSECT STOP 
DISPLAY 


An automatic error-dumping facility similar to that provided by the mTS 
SERRORDUMP command is provided for batch users. In the event of an error 
condition occurring during the execution of the prograa, a symbolic dump of 
the program which includes all variable locations is produced. This 
facility may be activated for the sample program by the command sequence 


$SET DEBUG=ON 
$SDS SET ERRORDUMP=ON 
SRON MEAN 

2 


4.0 4.0 
SENDFILE 
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Note that the MTS RUN command has been given instead of the DEBUG command. 
The error-duap facility may be deactivated by the command 


$SSET DEBUG<OFF 


The symbolic dump produces the variable storage for the saaple program in 
a format similar to the following: 


DUMP OF SECTION VA=5004F0 

RA SYMBOL TYPE VALUE HEX VALUE 
000000 DATA(1)  ‘'E* 4.0000000 41400000 
000008 paTa(2) ‘'E* 4.0000000 81400000 
000008 DATA(3) ‘'E* 0.08+00 81818181 
0000C8 DaATA(50) ‘'E* 0.0E+00 81818181 
o000cs ON tpt 42 00000002 
DUMP OF SECTION MAIN VA=5002aA8 

RA SYMBOL TYPE VALUE HEX VALUE 
0000B0 I tpt 42 00000002 
0000B4 MEAN te" 0.08400 81818181 
000088 s'tD ‘EY 0. 0£+00 81818181 
DUMP OF SECTION CALC va=5005c0 

RA SYMBOL TYPE VALUE HEX VALUE 
o000a0 x te 8.0000000 81800000 
0000a4 ¥ 'Et 16.000000 42100000 
o000a8 1 ty! 42 00000002 
O000AC MEAN "Et 4,0000000 41400000 
000080 MEAN2 ‘Et =8,0000000 €1800000 
000084 stD tEt 0.02400 81818184 
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CONVERSATIONAL QSAGE_OF_ATS 


Terminal devices enable the user to interact with a program, monitor its 
execution, and make decisions at any point of the execution. Terminal 
devices may be used advantageously to debug a new program. In batch mode, a 
single error generally terminates a run, while in conversational mode, the 
user may intervene when an error becomes apparent and immediately correct 
the error and try again. Thus only one terminal session may be needed to 
debug the entire program. MTS is historically a _ terminal-oriented system 
and therefore many system programs are available to the conversational user 
which are awkward or impossible to use in batch mode. Communication to ATS 
in conversational mode, like in batch jobs, is through the MTS command 
language. 


Users may gain access to MTS from a wide range of remote terminals which 
may be as complex as a remote computer. 


The most commonly available terminals at WSU are: 


The Selectric Typewriter Terminal! is very much like an ordinary electric 
typewriter. Its character set includes all commonly used text and programe 
ming symbols and it can be connected to the computer over great distances 
via telephone lines. Its output speed is about 14 characters per second and 
its carriage width is 130 characters. 


The Model _33 Teletype is a commercial telecomaunications unit which can 
be connected to the computer via telephone lines. Its output speed is 10 
characters per second and its carriage width is 72 characters. It does not 
provide lower-case alphabetics. It is, however, the most common and the 
most inexpensive terminal available. 


The Model 35 Teletype is functionally almost identical to the Model 33 
but is more ruggedly built. 


The Westinghouse 1600 Cathode-ray Terminal is functionally equivalent to 
a teletype terminal. It is noiseless and can be faster. Its main 
disadvantage is that no “hard copy" of the output is retained because of 
display on the screen. 


The Portacom is functionally equivalent to a Teletype terminal. It's 
main advantage is its portability. It can be carried like an attache case. 


The following two sections describe the physical characteristics of the 
most commonly used terminal devices, the Teletypes, the Westinghouse 1600, 


ivarious companies manufacture this type of terminal. They all, however, 
have a standard Selectric typewriter keyboard and carriage. 
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and the Selectric typewriter. If the user is already familiar with 
terminals, he may skip these sections. 


FUNCTIONAL CHARACTERISTICS OF TELEIIPES AND ASCII CODE TERMINALS 


The Model 33 and 35 Teletypes and the Portacom have a transmission rate 
of 10 characters per second and have a carriage width of 72 positions. 
These models do not provide lower-case characters nor several of the special 
symbols used in programming. Some rodels have paper tape reading and 
punching equipment built into then. 


The Westinghouse 1600 Cathode-ray Terminal has a transmission rate (on 
WSU STS) of 30 characters per second and a screen width of 80 positions. 
This model behaves exactly like a Model 33 Teletype except for the keys on 
the extreme left side which manipulate the display and the cursor. 


Most keys and controls are common to all Teletypes. The positions and 
shapes vary considerably, but their functions are identical. 


Most Teletypes are capable of both halfeduplex and full-duplex modes of 
operation. In half-duplex aode, the keyboard is connected to the printer so 
that whenever a key is pressed it is immediately printed, as well as sent to 
the computer. In full-duplex node, the keyboard and printer are not 
connected. A character is printed only when sent from the computer. The 
switch for HDX-FDX operation is located on the acoustic coupler attached to 
the back, of the Teletype. Although Teletypes are capable of both half 
duplex and full duplex, WSU only supports half-duplex mode. 


The switch labeled "LINE", "OFF", and "LOCAL"® on the front of the 
Teletype turns it and the acoustic coupler on ("LINE") or just the Teletype 
("LOCAL") so that it may be used as a typewriter (or paper tape punch}. . The 
Westinghouse terminals have two rocker switches -- ON-OFF and LCL“RMT on the 
far right side to serve the same function. 


The ordinary character keys cn the keyboard act much like typewriter keys 
except that as their symbol is printed (if operating in half-duplex mode), 
the code for that symbol is sent to the computer. The SHIFT key selects the 
upper character on dual character keys. Note that some keys do not have an 
upper=shift function and may not be pressed in combination with the SHIFT. 


A special key labelled CTRL for ‘control’ is similar to the SHIFT key in 
that it selects an alternate function for a_ key. The code sent to the 
computer by a key pressed in ccmbination with the CTRL key usually does not 
represent a. printable character and thus no symbol is printed. Some CTRL 
combinations are used for editing purposes by the device support routines 
(for exaagple, backspace and ‘end-of-line'}. These combinations have been 
designated in this guide by ‘CONTROL-x* where x is the character key 
operated in conjunction with the CTRL key. Note that the labels on the 
upper part of alphabetic keys generally refer to the control function,. not: 
to the shift function. Some Teletypes have color-coded labels: white 
labels for shift furctions and red labels for control functions. 
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The LINE FEED key causes the paper to move up one line without changing 
the lateral position of the typing element. It also sends a LINE FEED 
character to the computer. This key is not used for any special purpose.: 


The RETURN key causes the typing element to return to the beginning of 
the line without spacing the paper. It sends a RETURN character to the 
computer and informs the computer that the user has completed a line. 


The RUBOUT key sends a character which is never received by MTS. 


The REPT key, when pressed in conjunction with any character key, causes 
that character to be repeated until the key is released. This is useful for 
spacing forward or for multiple 'backspaces'. 


The BREAK key causes an attention signal to be sent to the computer to 
interrupt the current operation. This key is located on the right side of 
the keyboard on the Model 33 Teletypes and to the left on the Model 35. Any 
input or output in progress will be terminated. Some Teletypes (ones with a 
built-in telephone dial) have a BRK RLS key, located at the left of the 
keyboard, which must be pressed after the BREAK key has been pressed, if it 
lights up. 


When the Selectric typewriter terminal is not connected to MTS it may be 
used as an ordinary typewriter. Power to the terminal is controlled by an 
ON-OFF rocker switch on the right side of the keyboard. This switch should 
be turned OFF when the terminal is not in use. 


Most of the normal typewriter controls exist on a Selectric terminal. 
There is a lever on the right rear of the typewriter cover which reduces the 
pressure on the paper and allows paper adjustment. A lever on the left 
adjusts the typing-head angle to compensate for varying thicknesses of 
paper. The red=topped lever on the carriage may be adjusted to increase the 
striking force of the typing head for darker copies. The "golf ball" typing 
elements may be changed to provide a variety of character sets. 


Left and right margin stops limit the travel of the typing element. The 
MAR REL key temporarily releases these stops. The margins may be used in 
conjunction with the margin editing facility of the device support routines 
to position the printing on the paper. A small pointer rides in a slot 
between the margin stops and indicates the current printing element 
position. 


Physical tab stops may be set using the CLR-SET rocker switch on the left 
side of the keyboard. These may be used in conjunction with the input 
tabulation editing facility of the device support routines. 

The Selectric terminal keyboard is very similar to that of an ordinary 
electric typewriter. When a character key is pressed, the symbol is printed 
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on the paper and at the same time the internal code for that character is 
transritted to the computer. The shift key allows upper and lower-case 
alphabetic characters to be produced and selects the upper or lower syrbol 
on dual-character keys. 


The TAB key causes the typing element to move to the next tab stop while 
sending the tab character code to the system. The BACKSPACE key moves the 
typing element back one position while sending a backspace character code to 
the systenr. 


The RETURN key causes the typing element to return to the left margin and 
Spaces the paper up one line. It also sends a return character to the 
system and locks the keyboard. The RETURN code informs the computer that 
the user has completed a line. The keyboard remains locked until the systen 
again requests input. While locked, all keys except ATTN are inoperative. 


The ATTN key is located on the upper right keyboard. When this key is 
pressed, an attention interrupt is signaled to MTS. 


To the left of the keyboard are three lights labeled READY (blue), 
PROCEED (green), and CHECK (red). The READY light is on when the terminal 
is connected to the Transrission Control Unit. When this light goes out the 
terminal has been disconnected from the system, The PROCEED light is on 
when the system expects input. The keyboard is unlocked until the RETURN 
(or ATTN ) key is pushed. The CHECK light goes on when a character has been 
incorrectly sent to (or received from) MTS. If the CHECK light is on when 
the PROCEED light goes on, the CD key must be pressed before the keyboard 
unlocks. If the CHECK light goes on, it is a good idea to check the line 
just transmitted to (or received from) MTS for errors. 


GENERAL OUTLINE FOR OSE _OF A TERMINAL 


fo initiate a conversation with MTS on a terminal device, it generally is 
first necessary to dial into the system via the telephone lines, There are 
two types of connections available to MTS through the phone lines. The 
first, called the ten ainute line, is a connection which only allows an 
elapsed terminal tise of ten sinutes per signon. If at the end of ten 
minutes the user has not signed off the ten minute line, MTS will sign the 
user off automatically. The second line called an unlimited line, does not 
have a specific elapsed time limit set on the line. The telephone nuabers 
ares 


577-0230 for a ten minute line 
577-0210 for an unlimited line 


Each telephone number listed is the first of an automatic trunk-hunting 
group. If the first nusber is busy, the telephone equipment automatically 
searches through the group of lines until a free line is found. If dialing 
from a phone which is part of the Wayne State University Centrex Systen, 
only the last five digits must be dialed. If there is no answer, dial 
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(57) 7-4799 for a recorded message on the status of MTS. If the line is 
busy, try again in a few minutes. 


Once the connection has been made, type the word "GO" and press RETURN. 
The system then causes an introductory line to be printed out which 
identifies MTS and contains the following information: 


(LOxx-yyyy) 


where "LOxx" is the code for the system device answering the call. Each 
port is considered a separate device by the systen. "LO" identifies the 
MEMOREX transmission unit, "xx" identifies a particular line of the 
transmission unit, and "yyyy" is the task number assigned to this session. 
This information is useful if difficulties arise in the operation of the 
terminal device. These numbers will aid the Computing Center personnel in 
tracking down the problen. 


If the terminal device is a Teletype, it must identify itself. Some 
Teletypes are equipped to automatically respond with a unique answerback 
identification. code. If the answerback is automatic, the device prints its 
identification code, and is then ready to begin the session. Otherwise, the 
user must manually enter an answerback. See the terminal guides below for 
details on how to sign on with each type of terminal. 


After all the initialization has been taken care of, MTS types the prefix 
character "#", and is ready to receive the first input line. The first 
command that should be entered is 


SSIGNON ccid 


where “ccid" is the user's MTS signon ID. The system then prompts him for 
his password by typing 


#ENTER USER PASSWORD. 
? 


The "27" is the prefix character used by MTS to prompt for a response fron 
the user. For each device there is a method to mask the printing of your 
password. (See the individual terminal guides below.) If the signon ID 
“ecid" is currently active and is allowed terminal time, and if the password 
is correct for the given ID, MTS will type out further information for the 
user on the terminal. This information takes the fora: 


#** LAST SIGNON WAS: time date 
# USER "“ccid" SIGNED ON AT time ON date 


This information gives the time and date for the last time “ccid" was signed 
on and the time and date for this sign-on. This information may be useful 
in detecting illegal use of the ID. After the above information has been 
typed, MTS again types a "#" on the terminal device indicating that the user 
is now signed on and that MTS is waiting for his next command. The user may 
now start his "conversation" with MTS, requesting the services he needs and 
providing the information MTS needs. 
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Prefix Characters 


The first character of each line identifies who is "writing" or who is 
"reading". On output lines, the prefix character is typed ahead of the 
message. When input is requested, the prefix character is typed at the 
beginning of the line and then the system waits for a response. If 
automatic line numbering is enabled, the prefix is followed by the line 
number. The prefix character for MTS command mode is the "#". Fora 
complete list of prefix characters, see the “System Command Language" 
section in this voluse. . 


Conversational] Operation 


During operation, the terminal device is in one of three modes: feceive 
mode, transmit mode, or idle wmode. Since Teletypes provide no special 
indication of when input is allowed, it is the user's responsibility to be 
aware of the current mode and act accordingly. On a Selectric terminal, the 
keyboard is locked whenever input is not allowed, so there is no possibility 
of typing at the wrong time. A description of each mode and the action to 
be taken by the user follows. 


RECEIVE MODE: The terminal device is in receive mode whenever a 
message is being transmitted from the system to the device. The first 
character of the output line is a prefix character that identifies which 
component of the system produced the output line. The terminal user should 
not type on the keyboard while the terminal device is in receive mode. 
However, output from the system may be interrupted at any time. (See 
“attention Interrupts" below.) 


TRANSMIT MODE: The terminal device is in transmit mode whenever the 
syster is waiting for the terminal user to type a line of input. A prefix 
character is printed at the first position of the line to show that input is 
expected and to indicate which component of the system is calling for input. 


IDLE MODE: The terminal device is in idle mode when there is no 
current input or output activity. This situation may occur when a progran 
is being loaded for execution, or when a considerable amount of computing 
must be done before another input record is required, or before another 
output line is transmitted. If the terminal device is in idle mode a signal 
is sent to it once every 28 seconds. This signal does not cause any 
printing to take place, but it does cause the terminal device to go through 
some internal antics that preduce a little bit of noise. This occasional 
noise can be taken as a signal. that the system is still operating. The user 
should not type. on the keyboard while the terrinal device is in idle sode. 
Entering characters during this time on a Teletype will cause an attention 
interrupt. (See "Attention Interrupts* below.) On a Selectric terminal the 
keyboard is locked in idle mode. 
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Control _Characters 


Control characters are provided to enable line editing froa the terminal 


device. 


Bach terminal device has its own special characters or combinations 


of characters defined to act as its control characters. There are five sain 
functions which are provided: 


(1) 
(2) 


(3) 
(4) 
(5) 


To delete all the characters of the input stream up to the 
"line-delete" character. 

To delete the last character of the input strean. On sore 
terminal devices the carriage actually backspaces and types over 
the deleted characters when the user corrects errors; on others, 
such as Model 33 and 35 feletypes, the carriage does not 
backspace. On a Westinghouse 1600 the cursor may be backspaced 
either by the controls on the left of the keyboard or by entering 
the CONTROL@H combination. 

To end an input line and to transmit the entered line to MTS. 

To signal an end-of-file. 

To signal that the next character should pot be. interpreted to 
have any special meaning, but should be transmitted literally. 
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Table of Control Characters 


Corr ena 


i { { 
{ Teletype { Selectric { 
{ { { 


| End-of-line ] RETURN or | RETURN { 
{ Character t CONTROL@S j { 
eH OO eee 


| { | 1 
{ Delete-line | CONTROLON { 


{ Character { j (underscore) j 
_—___-__-_—__—____—_—_--—— OH OOOO 
{ I t | 
| Delete-previous { CONTROL“-H { BACKSPACE { 
{ Character | t { 


{ Literale-next I CONTROL=Z { { { 
{ Character ! | \ 
sh HH 
{ { | { 
{ Attention { BREAK i INT or { 
{ Interrupt { { ATIN ( 
+--+} OH I 
| | I ( 
{ End-of-file { CONTROL=C 1 ¢ | 


[ee oo 


Zaput_ Restrictions 


Some terminal devices are able to produce lowercase as well as uppercase 
characters. Normally alphabetic characters in an input line are converted 
to uppercase characters before the line is transmitted to MTS. Thus 
"S$SIGNON" and "$signon" produce the same effect. If this conversion is not 
desired, a device command is available which enables lowercase letters to be 
transraitted. 


Bach terminal device has a maximum input line length, but for records 
read in MTS command mode (prefix character "#"), input may be continued froa 
one line to the next. If the last character of a line is a ninus sign ‘%~", 
then the next line is assumed to be a continuation of the input line. The 
first character of the next line replaces the "=" of the previous line. 
There is a restriction on all terminal devices that the total length of an 
input line may not exceed 120 characters. Up to 255 characters in an input 
line may be sent to MTS by sending continued lines (lines terminated with a 
minus sign). 
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The maximum output line length defaults to the carriage width of the 
terminal device. However this may be extended up to 255 characters by the 
"length" device command. Extended output lines are continued as multiple 
carriage lines until the entire line is printed. 


Attention Interrupts 


Normally an attention interrupt is a signal to MTS to interrupt whatever 
it is doing, and to return for another command or data line, An attention 
interrupt can be used, for instance, to interrupt a LIST command if all the 
pertinent information has been typed out, or to interrupt a program in 
execution, if an error is spotted. A program initiated by a $RUN command 
that has been interrupted (after execution begins) may be restarted at the 
point of the interruption by using the RESTART command. There are a few 
occasions when an attention interrupt from the terminal device is ignored. 
These are: 


(1) during the sign-cn procedure, 

(2) during the sign-off procedure, 

(3) when an attention interrupt has already been received, but 
not yet processed, 

(4) when the executing program refuses to honor the interrupt. 


Otherwise, the user may interrupt either during input or output operations. 
Since each device has its own method for generating an attention interrupt, 
see the individual terminal device guides below for the procedure. What 
happens next depends on many things, but generally the comment 


ATTENTION INTERRUPT AT xxxxxxxx 
or the comment 
ATTN! 


is typed out. The first comment occurs only if a program was in execution 
at the time of the interruption. In this case, "xxxxxxxx" is the 
hexadecimal address at which execution was interrupted. The second comment 
is given if no program was in execution when the attention was received. 
After one of the above comments has been printed, MTS will type the prefix 
character "#" to indicate that once again MTS is ready for an input command. 
At this time the user may enter a new input line. (Note: some systea 
components or user's programs may intercept the attention interrupts, rather 
than allowing MTS to service the interrupt. For such components, the prefix 
character printed after the attention has been recognized is the prefix used 
by that component.) 
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Error. Conditions 


K number of error conditions may result during the transmission from the 
terminal device to MTS. When this happens, an error sessage is printed out 
on the terminal device. One of the sost common error conditions is the data 
check which indicates that the characters transmitted by the terminal were 
not received correctly by MTS. In this case the message printed is: 


LINE DELETED: DATA CHECK 


and a new prefix character is printed out so the user can re-enter the line. 
All the error messages take this form, giving the "line deleted" message and 
the reason for the deletion. If a line greater than 120 characters long 
(including control characters) is sent, the message: 


LINE DELETED: LOST DATA 


appears. The line must be re-entered (continued with a "«" if necessary) in 
lines of less than 120 characters. 


Device Support Routines 


The MTS system contains a set of subroutines for each type of terminal 
which interfaces that terminal with the system. These subroutines are 
called Device Support Routines or DSRs. The DSR for each terminal is 
responsible for doing the actual I/0 with the device, performing error 
recovery if necessary, recognizing attention interrupts, helping MTS with 
the sign-on/sign-off procedures, and so on. The DSRs also provide the 
conversational users with several typographical services which are discussed 
below. 


Device. Commands 


The terminal user say issue conmands to the Device Support Routines. 
These are not to be confused with HTS commands or data lines. Since the 
DSRs inspect the input from the terminal first, they can intercept commands 
intended for them. Such commands are called “device commands" because they 
deal with device<oriented functions and not system operations. Basically, 
device commands enable the user to control the formatting of input and 
output at his terminal. Device commands fall into six groups as follows: 


(1) Comgands that é#llow the user to describe the carriage format for 
his terminal; these include left and right sargin settings and tab 
stops. 

(2) Commands that allow the user to specify upper-case conversion 
and/or hexadecimal input. 
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(3) Commands that allow the user to redefine the characters having 
special significance on input (literale-next character, etc.). 

(4) The length command which allows the user to establish the 
truncation length for output lines. 

(5) The reset command which reinitializes everything that can be 
changed by a device ccmmand. 

(6) Commands which control special system functions. 


The following lists contain only the more commonly used device commands. 
For a complete list, see MTS Volume 4 Terminals and Tapes. 


Device commands may be issued whenever the system is requesting input. 
The device command is intercepted by the DSR, and, after it is processed, 
the DSR again prompts the user for the input line expected by MTS. A 
correctly specified device command is acknowledged while an invalid command 
is discarded and produces an error message. Device commands aust be 
prefixed with the "device-command character", initially a percent sign 
("%"). This is analogous to the "$" for MTS commands although it may not be 
omitted. This character may itself be redefined by a device command. Note 
that all lines beginning with the device-command character (initially %) are 
treated as device commands. If a data line begins with the device-command 
character it must be preceeded by the literal-next character (!) or the 
device-command character must be changed with the DCC device command. 


Device commands may also be issued by using the S$CONTROL command. The 
format of the device command is the same as that described below, except the 
command must not be preceded by the device-ecommand character (%). For 
example: 


SCONTROL *SINK* LEN=255 


A short description of device commands follows. Braces indicate that a 
choice must be made between two parameters, brackets indicate optional 
fields, and the elipsis (...}) indicates repetition of the previous field. 


Commands in Group 1: 


%LMAR 
SRMAR 


The "left margin" and “right margin" commands determine the logical 
carriage length -- the maximum number of printed characters in an output 
line. Input lines are unaffected by this command. 


Form: %LMAR=nl 
SRMAR=nr 


where nl and nr are non-negative integers (less than the physical carriage 
length) representing the positions of the left and right logical margin 
stops respectively. The difference nr-nl determines the number of charac- 
ters printed in each output line. The line begins at the left margin on the 
typewriter and is truncated after nr-nl characters have been transmitted. 
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(The prefix character is not counted as part of the line.) Note that ar 
must be greater than nl. 


&TABI (for input) 
STABO (for output) 


The tab commands turn logical tab node on or off, redefine the Logical 
tab character, and set the logical tab stops. 


FORM: STAB{I{O}=ON;( char, ]dd,... 
STAB {I (0} =OFF 


The single character "char" is used as the logical tab character. The 
default for this character is the "TAB" key on a Selectric terminal and a 
CONTROL“I on a Teletype or Westinghouse. The quantity "dd,..." is replaced 
by a Sequence of up to nine integers setting the tab positions. Note that 

tab stops on the terrain (if apy) baye no relation to the tab 
s The "ON" or “OFF" specifies whether logical tab stops are to be 
enabled or disabled respectively. The "I" or "0" specifies whether editing 
is to be done to input or output lines. If editing is enabled, each time 
the logical tab character is encountered in the line being processed, the 
tab character is replaced by enough blanks to move the coluan pointer to the 
next tab position specified in the TAB command. If the current coluan is 
already beyond the last tab position, the tab character is left unchanged. 


RGOLF 

This command sets the internal tables to correspond to different typing 
elements ("golf-balis"). It is valid only for Selectric typewriter 
terminals. 

Porm: %GOLF={963({ 988} 

The nurabers 963 and 988 are the numbers stamped on the typing element. 
The default is 963. All Selectric typewriter terminals on WSU's campus have 
this typing element. 

Commands in Group 2: 
&K 

The case conversion command specifies the type of alphabetic conversion 
for input lines from the keyboard. This command is defined only for 
Selectric typewriter terminals. 

Forrm: %&K= {LC {UC} 
SK=0C causes all alphabetic input from the terminal to be translated into 


upper case (this ig the default).  &K=LC causes alphabetic input to be 
transmitted in the same case as typed. ; 
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RHEX 


The hex command controls the hexadecimal input editing mode and defines 
the hexadecimal input delimiter. 


Form: SHEX={ON(OFF}[ ;char ] 


where ON and OFF enable and disable this mode, and char is any character. 
The character "char", if supplied, becomes the hexadecinal deliniter. 
Default mode is OFF, with "char" set to a prime ('). 


Hexadecimal editing (when ON) occurs after the usual editing for delete 
line, and so on. When the delimiter is encountered in an input line, the 
characters following are interpreted as hexadecimal input, two characters 
per byte, until the delimiter is again encountered. Commas may be used at 
byte boundaries and are ignored. Hexadecimal input may be used any nuaber 
of times in a line but the line must end with a normal character. Mhen 
invalid hexadecimal characters (other than the digits 1-9 and the letters 
A-F) are encountered, the message LINE DELETED: INVALID HEX INPUT is given. 


Commands in Group 3: 

The third group of commands are all of the forms: 

%com=char 

where "com" is a three letter command code describing the function to be 
assigned a new special character and "char" is the character (any character 
on the keyboard may be used) to be assigned to that function. The default 


special characters, their names and the three letter command codes are given 
in the following table. 


Name Default for Default for Command 
Selectric Teletype Code 

delete previous character bs (backspace) CONTROL@= 8 DPC 

delete line character (underscore) CONTROL“N DLC 


end of file character 
literal next character 
device command character 


CONTROL-C EFC 
CONTROL-Z LNC 
% pcc 


m= al 


When a special function is assigned a new character by means of the 


appropriate command, the previously assigned character loses its special 
status and may be used as text. For example: 


ADPC=+ 
%DLC=" 


make the backspace and underscore ordinary text characters. The sequence 
AB+C gives AC, and the line 1AB"2CD results in line 2 becoming CD. Care 
should be taken when special characters are redefined, as one tends to 
forget and tries to use the old special characters out of habit. 
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While it is possible in a few cases to have the same character assigned 
to two different functions at the same time, it is not recoanended. 


Commands in Group 4: 
*LEN 

The LEN command defines the physical length of output lines. 
Porm: %LEN=(ddd{ OFF} 
where ddd is in integer between 1 and 255. If ddd is less than the logical 
carriage length (see the %LMAR and %RMAR commands), the outpat line is 
stopped after column ddd and continued om as many lines as necessary to 
either complete the line or fulfill the logical carriage length. Continua- 
tion lines are identified by an asterisk in column 1, and prefix characters 
do not count in this process. %LEN=OFF causes a return to the default node 
where the physical line length is the same as the logical carriage length. 
Commands in Group 5: 
*RESET 
Form: %RESET 

The RESET command resets everything that was changed by a device comsand 
to its default value. 
Commands in Group 6: 
SBDCST 
Form: %BDCST=(ON| OFF} 

This command enables or disables the operator broadcast messages. If 
%BDCST=OFF is specified, no sessages sent by the operator are printed at the 
terminal. This command is useful for producing uninterrupted output at a 
terminal. The command should be used with caution, since the user will not 
receive any messages from the operator (including notices of shutdown}. The 
default is ON. 

SRARN 
Forma: %WARN= {ON {OF?} 

This command is only defined for ten minute lines (577-0230). If WARN is 

OR, the message TWO MINUTES LEFT is typed on the terminal when two of the 


ten sinutes remain. This gives time to finish and sign-off. The default is 
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Processing of Input _ and Output Lines 


For the user sitting at a terminal, there are several levels of 
processing that an input or output line must pass through. Each of these 
levels analyzes the line, looking for a particular set of control characters 
or commands and performs the appropriate conversions. This process say be 
best explained by using a picture and an example. 


Consider the case of a user sitting at a terminal and atteazpting to enter 
a line into a file, If he is at a terminal which supports both upper and 
lowercase letters, he will be concerned about if, and when, lowercase 
letters are converted to uppercase letters. This conversion may occur at 
any one of several levels depending on which device conmands, global 
Switches, or I/O sodifiers have been specified. 


Ce ree ee 
{ Terminal Device ( 
eric trcnnpratiennecneend 
| 
{ 


( Transmission { 
1 Control Unit { 


{ Terminal Device ] 
{ Support Routines | 


a er | 
( 
{ aaa | Es ee | 
oe | MTS ( { ( 
{ DSR t---—4 MTS ] 
co Interface | ] i 
{ enn rl a | 


] File Routines ] 
ne | 
( 

{ 


{ File 


After a line has been terminated and transmitted, an interpretation aust 
be made of what has been typed. Line editing is performed either by the 
transmission control unit or the terminal device support routines, depending 
on which transaission path is used. 
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First, the transaission control unit processes an input line by removing 
rubouts (for a teletype). 


Second, the device support routine (DSR) for the MEMOREX unit processes 
the line editing functions in the following order: 


(1) Line termination characters (RETURN) 
(2) Literalenext characters 

(3) Delete-previous characters 

(4) Delete-line characters 


If an end-of-file syabol remains as the first character in the input line, a 
logical end-of-file is returned to MTS; otherwise, the edited line is 
returned, unless the line is a device command. After a device command is 
processed by the DSR, a new line is requested from the terminal. 


Upper and lowercase conversion may be perforaed at this level by a DSR. - 
If the device command &K*UC is in effect (the default case), all lowercase 
letters are converted to upper case. If the device command %K=LC is in 
effect, all lowercase letters remain as lowercase letters (no conversion 
takes place). 


The third part of the system to process the input line is the DSR 
interface to MTS. This part processes the I/O modifiers common to all I/O 
devices. If the user had entered a line using the command 


SCOPY *SOURCE*@UC FILE 


all lowercase letters conning from *SOURCE* would be converted to upper case. 
If this uppercase conversion had already been performed earlier, then this 
modifier would have no effect. Uppercase conversion may also be specified 
for input lines by giving the MTS command 


SSET CASE=0C 


The uppercase conversion specified by the SFT command affects only input 
lines read by the MTS command monitor, that is, those lines entered as MTS 
cormgands or data lines when in command mode (with a "“#" prefix). Lines 
entered in all other modes are not affected. Hence, lines entered via the 
COPY command are not converted by specification of this SET command. 


Tf the user had entered the line using the command 
SCOPY *SOURCE* FILE@UC 

all lowercase letters coming from *SOURCE* would be converted to upper case 
by the interface to MTS when the line is being sent to the file routines for 
processing. Hence the interface to MTS has two chances to process the input 
line and perforsa uppercase conversion. 

The file support routines are the last part of the systea to process the 
input line. The file support routines perform such functions as indexing 
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(the @I modifier). After all the line processing is corpleted, the input 
line is finally written into the file. 


'It is possible for the user to submit a job via batch from the terainal 
by using one of the pseudo~device names *BATCH*, *PRINT*, or *PUNCH*. These 
three pseudo-device names can be used anywhere that an output file or device 
name (FDname) can appear. (Refer to the section Files and Devices for 
details.) Thus, for example, one can $GET one of these names, $COPY to it, 
assign it to SPRINT on a SRUN command, and so on. In the following 
paragraphs, the term *...* refers to any of the three pseudo-device names. 


The actions of these pseudo-device names differ somewhat between batch 
mode and conversational mode. The following table summarizes the 
differences. 


Pseudo=-Device Action in Action in 

—-~——Nase Conversational Node Batch Mode 

*BATCH* A receipt number is printed A receipt number is 
and the output written to printed and the output 
it is used as a batch job. written to it is used 

as a batch job. 

*PRINT* A receipt number is printed The output written to 
and the output written to it is written to the 
it is printed on the line line printer. 
printer. 

*PUNCH* A receipt number is printed The output written to 
and the output written to it is punched on cards 
it is punched on cards. only if the "CARDS=" 


parameter is specified 
on the signon card. 


The data written to *BATCH* must contain the $SIGNON command and 
password, and must contain all the necessary MTS commands to control the 
job. The data written to *PRINT* are lines which are to be printed on the 
line printer. No commands are necessary (they would just be printed). The 
data written to *PUNCH* are lines which are to be punched on cards. No 
commands are necessary. 


In conversational mode (and in batch sode for *BATCH*), when an *...* is 
opened (that is, when the first line is written on it), a receipt number is 
printed. When it is closed (when the last reference to it is released), it 
is released to HASP, and an appropriate message is printed. The next 
reference to an *...* produces a new receipt number. For example, if a user 
types: 
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$LIST F *PRINT* 
the system responds with: 
*PRINT* ASSIGNED RECEIPT NUMBER 602743 


soon followed by: 
*PRINT* 602743 RELEASED 


Whenever an *...* is opened, certain HASP resources are allocated to 
process the output, and they remain allocated as long as *...* remains open. 
However, Since the number of HASP resources is fixed, it may happen that all 
of thea are already allocated, in which case the user is told: 


*,..* IS NOT AVAILABLE 
If this happens, he should wait a few moments and try again. 


There are a nusaber of options the user can specify regarding the 
disposition of an *...*. These may be specified either on the SCONTROL 
command or by the CONTROL subroutine. Except for HOLD, RELEASE, and CANCEL, 
these options are the same as the options available on the $SIGNON command 
for batch jobs. (See the $SIGNON command description for a description of 
these options.) The following table lists the options and gives the 
pseudo=device names for which each option is valid. More than one option 
may appear on a single SCONTROL command. The abbreviation (if any) is 


underlined. 

Option Pseudo=Device Nanes 
PRINT=TN or PRINT=QN *PRINT* 

ROUTE=xxxx *PRINT*, *PUNCH* 
PROUTE=xxxx *PRINT* 

CROUTE=xxxx *PUNCH* 

COPIES=x *PRINT* 

HOLD *BATCH*, *PRINT*, *PUNCH* 
RELEASE *BATCH*, *PRINT*, *PUNCH* 
NANE="d nane' *PRINT*, *PUNCH* 

CANCEL *BATCH*, *PRINT*, *PONCH* 


Note that any option not allowed on *BATCH*, may be used on the S$SIGNON 
command of the batch job. 


The HOLD option gyst be used if any other options are desired. For 
exarnple, simply stating SCONTROL *PRINT* PRINT=TN will not produce the 
desired result. For any option to take effect, *...* must be open. 
Specification of the HOLD option for an *...*, opens it and keeps it open 
until the RELEASE (or CANCEL) option is used. For exanuple, to copy the file 
named F to the TW printer, the following commands could be used: 
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SCONTROL *PRINT* HOLD PRINT=TN 
SCOPY F *PRINT* 
SRELEASE *PRINT* 


The HOLD option, since it keeps an *...* open, may also be used to allow 
copying several files to an *...* and producing a single batch job. 


If the *,...* is still open, and it is found that an error has been made, 
the data written to the *...* may be deleted, and the *...* released, by the 
command: 


SCONTROL *...* CANCEL 


If the *...* is already released, the SCANCEL command must be used. If the 
ATTN or BREAK key is pressed while an *...* is opened, the *...* is 
automatically held and a message to that effect is printed. The user may 
then continue, cancel it, or release it. 


In the following example, a batch job is set up to compile a FORTRAN 
program, two documents produced by *FMT are printed as one job on the fN 
printer, and the output from a WATFOR job is sent to the QN printer. The 
jobs go immediately into the respective queues (batch and print) and are 
executed (printed) as soon as possible. The lines typed by the user are in 
lower case; lines from the system are in upper case. - 


#get -file 

#READY 

#number 

# 1_$$signon myid t=2m p=150 * batch demo 
# 2_password 

# 3_$$create obj size=6p 

# 4 $$run *ftn par=source=ayfyle load=obj 

# 5_$$signoff 

t 6_Sunnumber 


#copy “file *batch* 

>*BATCH* ASSIGNED RECEIPT NUMBER 600005 
#*BATCH* 600005 RELEASED 

#control *print* hold 

#*PRINT* ASSIGNED RECEIPT NUMBER 600007 
#control *print* print=tn name='w smith! 
#run *fat scards=doct sprint=*print* 
#EXECUTION BEGINS 

#EXECUTION TERMINATED 

#run *fat scards=doc2 sprint=*print* 
#EXECUTION BEGINS 

#EXECUTION TERMINATED 

#release *print* 

#*PRINT* 600007 RELEASED 

#run *watfor scards=prog sprint=*print* 
#EXECUTION BEGINS ‘ 

#*PRINT* ASSIGNED RECEIPT NUMBER 600011 
#EXECUTION TERMINATED 
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#*PRINT* 600011 RELEASED 
# 


Since *BATCH* is, in reality, a separate job entry in the execution 
queue, *BATCH*® is not executable if you are still signed on the terminal 
under the sarge signon id that you sent to *BATCH*. *PRINT* and *PUNCH* do 
not operate in the execution queue. Consequently, this rule does not apply 
to either of these pseudo-devices. 


Tersinating a Session 


When the terminal device is in transmit mode, the user should type in a 
SSIGNOFF command. After the command line is scanned, MTS closes all files 
and types out a number of statistics gathered about the use of the computer 
during the session. These statistics include: 


The time of sign-off 

The elapsed time in seconds 

The CPU time used in seconds 

The CPU storage virtual semory integral in page-aminutes 
The vait-state virtual senory integral in page-hours 
The number of tape sounts 

The tape drive usage in asinutes 

The number of drum reads 

The approximate total cost of the job 

The charge for permanent file storage since the last signoff 
The remaining balance of funds for the ID 


If the user does not want to wait for the statistics to be typed out, he 
may enter the command 


SSIGNOFF SHORT 
with the result that the sign-off statistics are abbreviated. 


If the user only wants to know the approximate cost of his session and 
his remaining balance, he may enter 


SSIGNOFF $ 


After the statistics have been written, the telephone line to MTS is 
automatically disconnected. 


QSING_A_ TELETYPE OR WESTINGHOUSE 1600 


Since almost all Teletypes on campus are Model 33 Teletypes, the 
following description is limited to that sodel. If your Teletype is 
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different, such as a Model 35 or either of the ASR models, see the person 
who is leasing it or call Academic Services (577-4778) if you need 
assistance. 


Initiation 


Most Teletypes and the Westinghouse 1600's are capable of both halfe- 
duplex and full-duplex mode of operation. For use with MTS, a Teletype aust 
be capable of half-duplex operation, and must be put into this mode. 


Turn the main switch on the Teletype to "LINE", or press the "ON" and 
"LINE" switches on the Westinghouse. If necessary, also turn on the 
acoustic coupler. Allow the Westinghouse about 20 seconds for warm-up. 
Place the telephone receiver in the acoustic coupler in the appropriate 
position (the position is marked) and dial the MTS number (577-0210 or 
577-0230). If, after a few seconds, the light on the coupler fails to cone 


on, lift the receiver and listen. If the line is busy, try again in a few 


minutes. If there is no answer, call 577-4799 for a recorded message on the 
status of MTS. When the light on the coupler comes on, type the word "Go" 
and press the return key. The Teletype then prints the introductory lines: 


MTS (LOxx- yyyy) 
WHO ARE YOU? 


asking the Teletype to identify itself. Most Teletypes on campus do not 
have automatic answerback mechanism and require a manual answerback. Since 
MTS does not make use of the answerback, it is sufficient to press "RETURN". 


The initial word "GO" tells the MEMOREX transmission controller that the 
terminal is a Teletype (or Westinghouse) and automatically sets the speed. 
On a Teletype, the speed is fixed at 10 characters per second. On a 
Westinghouse, the speed is set at installation time for 30 characters per 
second. 


Once all the initialization has been taken care of and the "#" prefix 
character appears, the user may enter his sign-on and password. To protect 
the password, the Teletype may be temporarily put into full-duplex mode by 
using the switch on the acoustic coupler. The password will not be typed as 
it is entered. 


Control Characters 


The control characters for the Teletypes default to the values listed in 
the table below. The first four entries may be changed by using the device 
commands given in the table. The remainder of the entries are not 
changeable. For the entries such as CONTROL@H, the key labeled CTRL and the 
specified letter must both be pressed simultaneously. The name in paren= 
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theses below the code for the character may appear on the top part of the 
corresponding key (possibly in red}. 


ee ee ee ee ee ee ae 
{ Default H Meaning | How to | 
( Character { | Change | 
HOOP  e===S!_ Ft 
{ CONTROL<-# { The previcus character is deleted. { RDPc= | 
( (SOH) 1 1 | 
OOO eee een eee 
{ CONTROL@C | A logical end-of-file is presented { SEFC= | 
i (ETX) { to the program. Any other contents { 1 
] { of the line are not returned. { { 
{ CONTROL@N { The current input line is deleted. { &DLC= | 
{ | The Teletype returns to transmit sode { ] 
1 | for the line to be retyped. i { 
{ CONTROL-Z { The next character typed is treated {| SLNC= | 
{ { as an ordinary character, even j { 
{ { if it is a CONTROL“-H, CONTROL@-C, i f 
{ { CONTROL@N or a CONTROL-Z. { t 
| { This has no effect on characters t ] 
{ { below. ] { 
-—— HO OOOO enn ee 
{ RUBOUT { This character is completely ignored { { 
j | by the MEMOREX. { t 
HO Oe eee need 
| CONTROL=-0 { This character terminates a transmit { { 
{ (%-0N) { operation in a normal manner. 4 ! 
{ RETORN or { This character terminates a transmit { | 
{ CONTROL“-S { operation in a normal manner. { { 
{| CONTROL-E { This character terminates a transait { { 
| (WRU) } operation in a normal manner, unless { t 
{ j it is the only character sent, when { t 
t ! 


j it causes MTS to see an invalid command. | 
[ Eee EES Seen EEE ee | 


Regardless of the other characters (including other control characters) 
in it, the line must be ended by a return, X“ON, X-OFF, or WRU before TS 
receives it. There is no indication that the CONTROL@-H has been entered on 
the Teletype. The replacement character is typed directly next to the one 
deleted. 


To issue an attention interrupt from the Teletype, the BREAK key is used. 
If the Teletype is a Hodel 35, the BRK RLS key must be pressed after the 
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BREAK. Then the attention interrupt will be recognized and a new command 
may be entered. 


Using a Westinghouse 1600 


Except for a few minor differences, a Westinghouse 1600 Cathode-Ray 
terminal acts exactly like a Teletype. These differences are discussed 
here. It is assumed that the reader is familiar with the rest of the 
Teletype section. 


The Westinghouse 1600 has two white switches to the right of the keyboard 
which should be turned to "ON" and "LINE" respectively. The acoustic 
coupler has a separate ON-OFF switch to turn on. Also the HALF DUPLEX-FULL 
DUPLEX switch should be in the half duplex position. 


Both sets of number keys transmit the same characters. To the left are 
the buttons that control the display. These buttons currently send signals 
to MTS. The four arrow buttons move the cursor (the "underscore" that 
indicates the next position to be "typed") in the direction of the arrows. 
If held down, the motion continues until the button is released. The left 
arrow button may be used to backspace over characters that have been deleted 
by sending a CONTROL“H to MTS. The CLR PAGE button erases the display and 
moves the cursor to the first character position on the top row of the 
display. The HOME button shifts the cursor to the first coluan of the top 
line. 


It is possible to suppress the password by changing the coupler switch to 
FULL DUPLEX, typing the password, and then moving it back. However, it is 
easier to hold one's hand over the screen, enter the password, press RETURN 
and then press the CLR PAGE button (thus erasing the screen). 


The screen can hold a maximum of 20 lines. When the bottom line has been 
filled, the display is automatically shifted up one line to make room for 
the next. The top line is lost in this process. 


USING A_SELECTRIC TYPEWRITER TERMINAL 


Initiation 


Por use as an MTS terminal, the LCL-COM switch, located on the rear panel 
of the terminal (if there is one), must be switched to COM, the power switch 
on the acoustic coupler, and the main power switch on the right side of the 
keyboard must be “ON" before dialing the telephone number to connect the 
terminal to MTS. Next, place the receiver on the acoustic coupler and dial 
the MTS numbers (577-0210 or 577-0230). The blue (ready) and the green 
(proceed) lights should come on. If they don't, pick up the receiver and 
listen. If there is no answer, call 577-4799 for a recorded message of the 
status of MTS. If it is busy, try again in a few minutes. When the lights 
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on the terminal core on, type the vord "go" and press the return button. 
MTS will then type the introductory heading "MTS (LOxx*yyyy)* and return 
control so that the user may sign on. To protect the password, the sign-on 
and passvord should be entered on two separate lines. ATS prompts the user 
for the passvord and then types over the area where the password will be 
entered. As long as the password and sign-on are correct, the session with 
MTS can begin. 


Control Characters 

The control characters for the Selectric terminals are given in the 
following table. The first four control characters may be changed by the 
device commands given. 


t { 1 t 
t Defaelt | Meaning { How to f[ 
| Character | { Change { 
eae RRR lenemenenaneeeeeneemmannmnens amma | 
t BACKSPACE { The previous character is deleted. { £DPc= | 
t = | Everything typed before the underscore | &DLC= | 
| (underscore} | is deleted. { { 
t ¢ { A legical end-of-file return is { KEFC= ft 
| {| presented to the progran. ! t 
t ! | The next character typed is treated { SLNc= [| 
t { literally. t t 
aa na RRR RRS, RERRRRERREReRRaReRennmenmnennmnennnne Suammeanenmen | 
{ RETURN | This indicates the line is terminated. | t 


s ial I t_Restricti 

The Selectric terminal is capable of transritting both upper and 
lowercase letters. Normally, everything is converted to upper case before 
it is sent to MTS. If this conversion is not desired, lowercase letters say 
be enabled by using the device command %K=LC. 


hk physical input line may only contain up to 120 characters, but through 
continuations, a line of input may be extended up to 255 characters. 


Attention Interrapts 


An attention interrupt may be generated from the Selectric terminal by 
using the ATTH or INT key located at the upper right side of the keyboard. 
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BATCH USAGE OF MTS 
INTRODUCTION 


MTS batch jobs are turned in to the CDPC Production Control desk 
directly, through a distribution center, or through the remote batch station 
for processing. In batch mode, the user prepares a card deck which contains 
all the MTS commands, translator source statements or object decks, and data 
lines which are needed to accomplish the desired task (or tasks). Once the 
user has checked his deck for accuracy, he may submit the deck for 
processing. A receipt is given to the user, the deck is read into the 
computer and saved in a special file for later execution. The cards are 
usually returned to the user immediately if submitted to one of the 
Production Control Desks but may be saved for pick up by (or delivery to) 
the user. The job is then processed by MTS, together with many other batch 
jobs. Later, the results of the processing (the job output) may be 
retrieved at the Production Control desk, at a distribution station, or at a 
remote batch station, by the user with his receipt. The specific details of 
submitting and retrieving batch jobs and their output are given in the 
Pacilities and Services of WSU Computing and Data Processing Center for 
Academic Users (February 1973) and the manual Introduction to MTS @ WSU 
(January 1974). 


ADVANTAGES _AND_ DISADVANTAGES _OF BATCH USAGE 


Although many users need to have the interactive capability of conversa- 
tional mode, batch mode is satisfactory and even advantageous in certain 
situations. There will be few if any terminal users who will not make at 
least occasional use of batch mode. 


Since there are restrictions on the use of line printers, card readers, 
and card punches in conversational mode, those users wishing to make use of 
these facilities generally should use batch mode. This can be done by 
submitting a batch job, creating a batch job from a terminal (see the 
description of *BATCH* in “Conversational Usage of MTS" in this volume), or 
by using *PRINT* or *PUNCH* from a terminal. 


Batch mode may sometimes be more economical than conversational usage of 
MTS. Since the charge for a terminal session is based, in part, upon the 
elapsed real-time, the terminal user will find that he is being charged 
$3.00 an hour for just sitting and thinking. When running in batch asode, 
there is no charge for elapsed real-time, but there are charges for card 
reading, card punching, and line printing (which may approximate the 
real-time charges for a similar terminal session). 
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The major disadvantage of batch mode is that the user has no interactive 
Capability with his job. This limits his opportunities for error recovery 
and raking decisions depending on earlier results or conditions. Since 
there is currently no way for saking MTS commands conditional, every command 
is executed regardless of earlier results. Por exaaple, a disadvantage may 
atise in batch mode when the user wishes to compile and execute in the sare 
job. If an error has occurred during compilation, the object deck may still 
be executed even though it is erroneous. This effect may or aay not be 
desirable, but the user has little control over it. 


DIFFERENCES BETWEEN BATCH USAGE AND CONVERSATIONAL USAGE 


The dollar sign command flag "$" is required before all MTS comaands in 
batch mode. This is necessary to avoid interpreting data as command lines 
and causing irreversible dasage to files. 


In batch mode, MTS recognizes the following global parameters from the 
SIGNON command: 


Parameter Heaning Default 

TIME=t CPU time limit 30 seconds 

PAGES=p Printed page limit 50 pages 

CARDS=c Punched card limit 0 cards 

COPIES=n Number of copies of printed output 1 copy 

PRINT= (ON| TN} Printer character set Any character set 
ROUTE=station Output staticn for printed Input station 


and punched output 
PROUTE=station Outpat station for printed output Input station 
CROUTE=station Output station for punched output Input station 
(Default is CNTR if 
the input station has 
no punch unit.) 


If the user does not supply the parameters above for the SSIGNON command, 
the default values are supplied automatically and his job is held to then. 
The above global parameters are ignored in conversational mode. 


The S$DESTROY and SEMPTY commands do not require confirmation in batch 
mode, Confirmation is required only in conversational sode. 


The SERRORDUMP and S$SET ERRORDUMP=ON commands are effective in batch sode 
allowing the aser to produce error duaps for his job. These commands are 
not effective in conversational node. 

The HTS pseudo-device names have the following defaults in batch and 
conversational rode: 
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Batch Mode Conversational Mode 
*SOURCE* Card reader Terminal 
*SINK* Line printer Terninal 
*PUNCH* Card punch Card punch 
*APD* Active file Active file 
*MSOURCE* Card reader Terminal 
*MSINK* Line printer Terminal 
*PRINT* Line printer Line printer 
*BATCH* HASP batch queue HASP batch queue 


Prefix characters are not printed on the user's output in batch aode. 


An input line in batch mode is one full card (80 columns)*. If the user 
wishes to continue an MTS command line or a line being entered into the 
currently active file, a minus sign "=" can be punched in colugn 80 to 
indicate that the next card is a continuation of the first card. Terminal 
input lines are continued by typing a minus sign in the last coluan of the 
line. The maximum length for any line entered in MTS command mode is 255 
characters. 


The standard IBM 1403 Printer has 132 print positions for each line. 
Since the leading character of an output line to the printer is normally 
treated as a logical carriage control character, columns 2-133 of the output 
line are printed columns 1-132 of the printed output. (See the "Carriage 
Control" section in Volume 3 for a description of carriage control.) Output 
lines longer than 133 characters are truncated. 


The maximum length of an output line to the card punch is 80 characters. 
Output lines longer than this are truncated. 


STRUCTURE OF BATCH INPUT JOBS 


The first card in any MTS batch input deck must contain the SIGNON 
command with a "$" in column 1 and the letters SIG in columns 2-4 or the 
letters SIGNON in columns 2-7. The SIGNON command identifies the user to 
the system and supplies certain pieces of information to MTS and to the HASP 
batch processor which coordinates the execution of batch jobs within the 
systen. 


The pieces of information supplied to MTS are the user's signon ID and 
the global limits for CPU time, pages printed and cards punched. If the 
global limits are not specified, the default values, which are given above, 
are imposed. The information supplied to HASP concerns the number of copies 
of the user's output to be printed and the character set to be used for 
printing the output, and the designations of any remote batch station 
locations for sending printed and/or punched output. 


1 Lines submitted via *BATCH* may be up to 255 characters long. 
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The user's passvord gay be specified on the SSIGHON command, bat it is 
recounended that the password be entered left-justified in coluans 1-6 of 
the second card in the input deck. In this manner, the user's password is 
not printed on his output, thus providing added protection for the security 
of his password. The password may be changed by the command 


SSET PW=xxxxxx 


where "xxxxxx" is the new password. To prevent the printing of the new 
password when the $SET command is echoed, it is desirable to use the 
following sequence of MTS commands: 


$SET ECHO=OFF 
SSET PW=xxxxxx ECHO=ON 


This turns off the echoing of NTS commands on the user's output, changes his 
password, and turns echoing back on. In this manner, the second SSET 
command is not printed on the user's output. 


Normally the last card in the input deck is the S$SIGNOFF command. This 
terminates the user's job and causes a suamary of job statistics to be 
printed for the user's job. Omission of the $SIGNOFF command is equivalent 
to placing ‘ 


SENDPILE 
$SIGNOFF 


at the end of the deck. The job is still terminated and the statistics are 
printed... 


The following is an example of a short batch input deck for compiling and 
executing a FORTRAN prograa. 


SSIGNON X007 T=60 P=100 * SAMPLE PROGRAM® 
JABES 

SSET ECHO=O0PF 

$SET PW=BOND ECHO=0N 

SRUN *FTN PAR=LOAD=-OBJECT 


FORTRAN source progras 


SENDFILE 
SRUN -OBJECT 


e 


data 


SENDPILE 
SSIGHOFF 
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The user with ID X007 and password JAMES is signed on. The global tine 
limit is 60 seconds and the global page limit is 100 pages. A default 
punched card limit of 0 cards is imposed. The pair of $SET commands changes 
the password to BOND. The following cards compile and execute his prograa. 
The last card terminates his job. 


EXPLANATION OF PRINTED OUTPUT 


Associated with each batch job's printed output is a headere-sheet and a 
tail-sheet. These sheets are for ease of identifying the end of one user's 
printed output and the beginning of another user's printed output when 
separating them off of the printer. Both the header and tail sheets have 
the user's job receipt number printed on then. In the center of the 
header=sheet is a block WAYNE STATE monogram. The header=-sheet also gives 
the date and time that the job was processed by MTS, an echo of the user's 
$SIGNON command, and the user's signon ID, receipt number, and delivery code 
(if any) in block letters. 


The tail-sheet gives a statistical summary of the user's job and the date 
and time that the job was processed. In the center of the tail-sheet, the 
non-zero entries from the following list of job statistics are printed. 


The user SIGNON ID 

The project number 

The time of sign-on 

The time of sign-off 

The elapsed time in minutes 

The CPU time used in seconds 

The CPU storage virtual memory integral in page-ninutes 
The waite-state virtual memory integral in page-hours 
The number of cards read 

The number of lines printed 

The number of pages printed 

The number of cards punched 

The number of tape mounts 

The tape drive time used in minutes 

The number of drum reads 

The approximate total cost of the job 

The charge for plotting time 

The charge for disk space used since last sign-off 
The remaining balance of funds for the ID 

The time of the previous sign-on 


EXPLANATION OF PUNCHED OUTPUT 


Associated with each batch job's punched card output are three identical 
leading and three trailing separator cards to identify the beginning of the 
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user's punched output. Colaans 1-6 and 75-80 each contain a hexadecizal Yr. 
Between columns 7 and 74% are the user's receipt number and distribution code 
(if any). These separator cards should be removed before using the deck. 


LOCAL AND REMOTE BATCH 


Batch jobs submitted and returned at the CDPC or a distribution center 
are local batch jobs. Those submitted or retrieved elsewhere are renote 
batch jobs. Batch jobs submitted via *BATCH*, *PRINT*, or *PUNCH* are 
treated as local batch jobs unless routed to a remote station. 


The cDPC has a remote batch station in the basement of the Science 
Library for processing batch jobs. This station is connected by telephone 
line to the 360/67 at the CDPC. Batch input from the remote station is sent 
via telephone to the 360/67 for processing by MTS, and the output is 
normally returned via telephone to that station for printing. This renrote 
station has card reading facilities and a line printer for producing printed 
output. Card punching is not available at this station and the number of 
pages of output may be restricted since only one printer is available. The 
process of submitting a batch job and retrieving the output at this station 
is identical to that at the CDPC. The user may also use *BATCH* from a 
terminal or at this remote batch center to have his job run (or cards 
punched) at the CDPC. He may then pick up his output at the CDPC Control 
Desk or have it delivered. The output station code for the basement of the 
Science Library is SCIL. 


BASE 


The following information is not necessary for the running of batch jobs. 
It is presented only for those users wishing to know more about the 
operation of HASP. 


The MTS batch processing is controlled by a programs known as HASP 
(Houston Automatic Spooling Priority System). HASP was originally developed 
for the IBM Operating Systea, but has been revised to interface with the MTS 
system and accept BTS batch jobs. 


A batch job in HASP is processed in five phases: 


(t) input phase 
(2) execution phase 
(3) print phase 
(4) punch phase 
(5) purge phase 


At any one instant, several batch jobs are normally in each phase competing 
for the use of the various hardware and software facilities. During the 
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input phase, HASP reads in the job deck from the card reader and stores it 
on a special disk area to await execution. After the job deck has been read 
in its entirety, an entry is made on a HASP execution queue which indicates 
the job is now ready for execution in MTS. At the beginning of the 
execution phase, HASP creates an MTS task specifying the input disk area 
containing the job deck and specifying the output disk areas (for printed 
and punched output); a print disk area is always needed by a batch job, but 
a punch disk area is set up only if the batch job indicates that punched 
card output is to be produced. When the job execution is terminated, HASP 
is so informed, the MTS task is destroyed, and the disk area containing the 
job input deck is released. At this point execution is over but the job 
output (print and punch) is still on the output disks. After the execution 
phase, the job is placed in the print queue to initiate the print phase. 
During the print phase, the job's printed output is produced on a printer 
under HASP control. After the print phase, the job is placed on a punch 
queue if it produced punched output. Ina this case the job enters the punch 
phase during which its punched output is produced on a card punch. After 
the punch phase, or after the print phase, if the job produced no punch 
output, the job enters the purge phase. Here the job is placed on the purge 
queue and finally purged from the system. During the purge phase, all disk 
areas used by HASP for the job are released, if they have not already been 
released. At this time some information about the job is saved so that a 
user inguiring about his job can be told it is finished, This information 
is saved for 96 hours after the purge phase is completed. 


As mentioned earlier, at any one time there are normally batch jobs in 
each of the five phases competing for the hardware and software facilities. 
Hence, at any given instant, HASP must select the next job to be given 
processing time via some selection criteria. " To do this, HASP uses a 
priority basis to select jobs for processing. This means that jobs are not 
necessarily processed in the order in which they were read into the systen. 


Each job is assigned an execution priority when it is entered on the 
execute queue and a print priority when it is entered on the print queue. 
These priorities are numbers between 0 and 15 with the higher numbers being 
the higher priorities. 


The execution priority assigned to each job for execution is based on the 
CPU time limit specified on the $SIGNON command. Currently the priorities 
from 10 to 15 and 0 and 1 are unassigned. To compute the priorities, the 
following tables are used: 
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Execution Table Print Table 
Time Estimate Priority Printed Pages Priority 
(seconds) 
< § 9 
6-10 8 = 20 9 
11-30 7 21-50 8 
31-180 6 51-300 7 
18 1-300 E 301-1000 6 
301-600 4 > 1000 5 
601-1800 3 
> 1800 2 


Note that these priorities are subject to change without notice. The 
command "“SINQUIRE PRIORITY® prints the current table. 


To compute the execution priority, the priority number is taken directly 
from the execution table based on the time estimate on the SSIGNON card. 
For example, if a job estimates a time limit of 200 seconds, the execution 
priority is 5. Within a group of jobs which have the sage priority, jobs 
are executed in the order in which they are subsitted. 


To compute the print priority, the priority is taken directly from the 
print table based on the number of pages actuglly to be printed (not the 
page estimate). If 100 pages are to be printed, the print priority would be 
7. When a printer is free, the job with the current highest priority is 
chosen to be printed next. Within a group of jobs with the same priority, 
the jobs are printed in the order in which they completed execution. 


The punched output from a job, which is written on the punch disk while 
the job is executing, is always produced after the job has been printed. No 
priorities are associated with punched output. Jobs are punched in the sane 
order in which they finish printing. 


Note that HASP is only one of several programs running on the 360/67 
concurrently. The tise-sharing aspects of the machine apply to HASP as well 
as to MTS and user programs in MTS. To control the competition betveen 
batch jobs and terminal jobs for hardware facilities, there is a saxinua 
nusber of jobs which HASP allows in each of the processing phases (other 
than the input phase). These maxiaa vary during the day and over the sonth 
depending on the character of the MTS load level. At all times, the CDPC 
attempts to maintain a reasonable balance between batch processing and 
terminal usage in order to provide acceptable service to both user groups. 


The maximum number of batch jobs that HASP schedules for execution at 
once currently depends on a number of factors related to the load on the 
systen. This "system load" is a quantity computed regularly by MTS, and is 
based on a nuaber of factors, including: 


1. The utilization of the central processor. 
2. The number of virtual pages in use. 
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3. The hardware configuration (number of drums and amount of primary 
storage). 


Various "weights" are assigned to the usage of each of the above factors, 
and a total system load (a number between 0 and a few thousand) is computed. 
The weights are chosen so that a value of 100 indicates a fairly heavy load 
(or the system is operating at about 100% of its capacity). Values greater 
than 100 indicate that the system is being overloaded, hence service will 
become increasingly degraded. 


All numbers in the above tables are subject to change. Such changes are 
made to ensure satisfactory service to terminal users while running as many 
batch jobs as possible. In addition, changes may be made to these 
algorithms to take advantage of more information than is currently used. 


Now for the key question: "When will my batch job be done?" It's like 
this: with the present hardware, HASP can have batch jobs being read in 
locally, three being printed and ten in execution all at once. Also the 
remote batch station can be reading in jobs and adding them to the execution 
queue. Just when any particular job is done depends on how accurate the 
other users' time and page estimates are, how many terminal users are signed 
on and what they are doing, how many tape drives are in use, how much the 
jobs interfere with each other (using the same disk drive, etc.) and about 
twenty other factors (all interelated in complex ways). 


The SINQUIRE command, giving a job receipt number as the parameter, 
prints the location of the job in the batch process and the number of jobs 
queued ahead of it. This command gives the same information available to 
the operators about the status of a job. 
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FILES _AND DEVICES 


Data for a user's commands and programs is accessed from either files or 
devices. A file is a logical entity -- a set of lines of information. A 
device is a physical entity such as a magnetic tape unit, a card reader, or 
a port for a user's terminal to call. The general specification of a _ file 
or device is called a File or Device Nase in the MTS manuals, and is 
abbreviated as FDname. The purpose of this section of the manual is to 
describe the kinds of files and devices available, to give rules for 
constructing File or Device Names, and to show how they are used. 


FILES 


A file is an ordered set of zero or more lines. A line is a string of 
one or more characters (bytes). Both the maximum number of characters in a 
line and the maximum number of lines in a file depend on the type of file 
organization, which is discussed below. In the most restrictive case (line 
files), the maximum line length is 255 characters, and the maxiaua number of 
lines is about 10000 for an average file (depending on the length of the 
lines). : 

i’ 


Long-term storage in MTS is organized on the basis of files and hence is 
referred to as file storage. These files may contain source decks, object 
decks, data sets, output listings, writeups, etc. 

There are two bases of classification of a file: 

(1) The availability of the file. 
(2) The type of organization, 
These two characteristics are fixed at the time the file is created. The 


first is determined by the form of the file name; the other is specified by 
a keyword on the SCREATE command. 


The Availability of Files 


Public files are files containing components of the system, such as 
language translators and utility programs. Public files may be accessed by 
anyone, but are protected against modification. Volume 2 of the MTS manual, 
Public File Descriptions, contains descriptions of the public files avail- 
able to the user. Public files are also called system files or library 
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files. At WSU cCDPC the concept of a public file has been broadened to 
include all files maintained at the Computing Center. Consequently, file 
names prefixed by "CCAP:", "DEMO:", “HELP:", "NEW:", and “OLD:" are 
considered public files and have entries in Volume 2. 


Private files are files belonging to a specific user and may be accessed 
only by him, unless he gives permission to others for accessing them. There 
are two types of private files, permanent and terpporary. Permanent private 
files aust be explicitly created by the user with the SCREATE command (or by 
calling the subroutine CREATE). Once created, they. exist until the user 
explicitly destroys them with the SDESTROY command (or by calling the 
subroutine DESTROY). For the descriptions of these subroutines, see Voluse 


3, Subroutine and Macro Descriptions. 


Temporary files, also called scratch files, are created when their names 
are first encountered by MTS, and are automatically destroyed when the user 
signs off. They may be explicitly created (or explicitly destroyed), but 
must be explicitly created if other than the default characteristics are 
wanted, The default characteristics are discussed below and are also given 
in the SCREATE command description in this volume. 


Sisple_ Pile Nanes 


Permanent private file names consist of one to twelve characters. T€é 
more than twelve characters are specified, only the first twelve are used. 
The name can consist of letters (lower-case letters are automatically 
translated to upper-case), digits, and some special characters. It cannot 
contain blanks, commas, serni-colons, left-parentheses, at»-signs, or plus- 
signs. It cannot begin with an asterisk. 


Examples: FILE 
A_LONG_NAME 
321 
STATP6.S 


Internally, the nase of the file consists of the user's four character 
signon ID followed by the external twelve character name. In this way, the 
nares of one user's files are always different from those of other users. 


If a user wants access to a file belonging to someone else, he aust 
prefix the file name with the owner's signon ID, separating them with a 
colon "3", Thas if user AAAA wants to read the file NEWS of user BBBB, he 
must refer to it as 

BBBB: NEWS 
This, hovever, works only if the owner BBBB of the file has peraitted it to 
be read. See the section “Shared Files" below for details. 


108 Piles and Devices 


MTS Volume 1: MTS -=- The Systen 


April 1974 


Temporary (or scratch) file names consist of one to eight characters 
prefixed by a minus sign “=-". This prefix is called the scratch file 
character (SCRFCHAR), its initial value is a minus sign, and it can be 
changed by the MTS $SET command or the subroutine CUINFO. The legal 
characters for a temporary file name are identical to those for a permanent 
file name. 


Examples: e-T 
-OBJECT 
=-1 


Public file names either 
1). begin with an asterisk "*", cannot end with an asterisk, and 
contain a maximua of sixteen characters including the asterisk, or 
2) begin with "CCAP:", “"DEMNO:", “HELP:", "NEWS", or “OLD:" and 
contain a maxinum of twelve characters excluding the "CCAP:*", 
"DEMO:", "HELP:", “NEW:", and "OLD:" prefixes. 


Exaaples: *FTN 
*1 
*PROJECTACCOUNT 
HELP: DIRECTORY 
DEVICES 


A device is a specific discrete item of hardware, such as a card reader, 
a magnetic tape unit, or a port into the systema that a user's terminal can 
call. 


Each device has a four-character name and a three or four-character type. 
Each physical unit has a unique name, and all similar units have the sane 
type. Since the user generally does not know and should not care which 
specific devices are being used for his job, he uses pseudo-device nanes. 
Device names are generally used only by the operators and the systen 


programmers. Since the user occasionally sees device names, a brief mention 
is made here. 


Pseudo-Device Names 


In MTS, execution of a program is normally initiated by a $RUN command. 
This command requests execution of the program and provides MTS with the 
name of the file or device where the program is located. This procedure is 
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followed both for system prograas (such as translators) and for user 
programs. The $RUN conmand must specify the object program to be run and 
the file or device names to be used by the program. Thus, to run the 
FORTRAN IV translator, the $RUN command must specify where the source deck 
is located and where the object deck is to be placed, along with other 
information. 


These specifications in the $RUN command create immediate problems for 
the batch user in MTS. Since in a batch job, the input batch deck has. been 
read and placed on a special file (unknown to the user) before the job is 
started, the batch user has no way of providing in the $RUN command a 
specific name for the file containing the source deck and/or data cards. 
This problea is circumvented by the specification of pseudo-device napes- 


Pseudo-device names are synonyms for the actual files or devices used. 
They begin with an asterisk, end with an asterisk, and have from one to 
fourteen characters in between. The same characters legal for simple file 
names are legal here. There are nine pseudo-device names which are 
automatically predefined for the user. In addition, others may be defined 
with names of the user's own choosing when mounting removable voluses such 
as magnetic tape on devices. (See the description of the $MOUNT in this 
volume, and the "Magnetic Tape User's Guide" in Volume 4 for details.) 


The predefined pseudo-device names are as follows: 


*SOURCE* is defined by MTS as the current input (or source) file or 
device. Initially, the system defines ‘*SOURCE* to be the 
sane as *M#SOURCE*. Thus, for batch runs, *SOURCE* is 
initially defined as the location of the user's input deck, 
while for terminal usage, *SOURCE* is initially defined as 
the terminal at which the user is signed on. Therefore, any 
reference by a batch user to *SOURCE* is equivalent to a 
reference to the batch input deck. The batch user may thus 
use the name *SOURCE* in place of the (unknown) name of the 
input streaa. 


The user can redefine *SOURCE* by using the MTS SSOURCE 
command. If *SOURCE* has been redefined by a user, an 
attention interrupt at a terminal, or an end-of-file on 
*SOURCE*® when attempting to read a command, causes *SOURCE* 
to be redefined back to *MSOURCE*. 


*SINK* is defined as the current output (or sink) file or device. 
Initially, the systen defines *SINK* to be the same as 
*HSINK*, Thus, for a batch job, MTS initially defines *SINK* 
as the printed output stream for that job, while for terminal 
usage, *SINK* is defined as the user's terminal. (Thus the 
batch user need not know the specific name of the place being 
used to collect his printed output, since he may refer to it 
by the pseudo-device name *SINK*.) 


The user can redefine *SINK* using the MTS SSINK command. If 
*SINK* has been redefined by a user at a terninal, an 
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*MSOURCE* 


*HSINK* 


*APD* 


*DUMMY* 


*PUNCH* 


*PRINT* 


*BATCH* 
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attention interrupt causes *SINK* to be redefined back to 
*MSINK*. 


is defined as the master input (or source) file or device, 
which is the terminal in conversational operation and the 
file or device from which the batch job is being read in 
batch operation. *MSOURCE* may not be redefined by the user. 


is defined as the master output (or sink) file or device 
which is the terminal in conversational operation and the 
printed output for batch operation. *MSINK*® may not be 
redefined by the user. 


is defined as the current active file or device (if any). 
The active file or device is established by the MTS $GET or 
SCREATE commands. See the section "Putting Information into, 
Files" below for details. 


is defined as an infinite wastebasket for output (lines are 
accepted and they disappear) and an empty file for input 
(every time a line is requested, an end-of-file condition is 
returned). *DUMMY* is particularly convenient for specifying 
that output is to be ignored. 


is defined slightly differently for batch and terainal usage. 
For batch jobs, it represents the punched output for the job. 
Anything written to *PUNCH* is punched on cards, if the user 
has specified a big enough punch limit for his job. For 
terminal usage, writing information to *PUNCH* causes a new 
batch queue entry to be created to punch the output. A 
receipt number for use in picking up the punched output is 
printed at the terminal. 


is the same as *MSINK* in batch. From a terminal, writing 
information to *PRINT* causes a new batch queue entry to be 
created to print the output. A receipt number for picking up 
the printed output is printed at the ternminal. 


is defined for both batch and terminal usage. Writing 
information to *BATCH* causes a new batch job to be created 
to run the input. A receipt number for picking up the batch 
job's output is printed on *MSINK*, 


For a complete description of *PUNCH*, *PRINT*, and *BATCH*, see the section 
"Batch Jobs from a Terminal" in this volune. 
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SIMPLE_LILE BABES 


A siaple FOnage is one of the following: 


(1) Simple file name 
(2) Simple device nanze 
(3) Simple pseudo-device nane 


All siaple FOnages that are not pseudo-device names are noreaally interpreted 
as file names, even if they are identical to dewice aames, thus avoiding 
confusion between a file and a device with the same nae. 


To specify that an FDnase is a device name, it must be prefixed with a 
#>".8 For exaaple, 


RDR1 refers to file RDR1 
>RDR1 refers to card reader 1 


This prefix is called the device name character (DEVCHAR), its initial value 
is a greater-than-sign ">", and it can be changed by the SSET comaand or the 
subroutine CUINFO. 


Yo specify that an YFDnase is only a file name, it must be prefixed with a 
"4g", Continuing the exaaple above, 


#RDR1 algo refers to file RDR1 


This is generally necessary only when the first character of the file name 
is a flag character. For exaaple, 


-T refers to a teaporary file with nase T 
#-? refers to a permanent file with nase -T 


This prefix is called the file name character (FILECHAR), its initial value 
is a pound-sign "€*, and it can be changed by the $SET command or the 
subroutine CUINFO. 


The action of a file or device may be changed by appending to the sisaple 
FDnase one or sore I/0 modifiers. Each sodifier consists of an ate-sign "2" 
(aneanonic for *attribute"), followed by the modifier name. A modifier nane 
may be preceded by a notesign “~" or a ainus-sign "-" to reverse its 
aeaning. For example, 


4A user may not ordinarily refer to a device directly. Pseudo-device names 
must be used instead. 
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SCOPY A *SINK*@-CC 


in a batch job causes file A to be copied to *SINK* (that is, printed) with 
the modifier specifying no carriage control. A detailed description of the 
modifiers and their meanings is given in Appendix A and in Volume 3. 


LINE_NUMBER_ RANGES 


The usage of a file or device may be augmented or restricted by appending 
a line number range specification to the FDname. The form of this 
specification is 


(b,e,i) 


where b, e, and i are each line nyugbers. The b, e, and i are, respectively, 
the beginning line number, the ending line number, and the line number 
increment. Any combination of these three items may be omitted. Trailing 
commas resulting from the omission of items may also be omitted, but leading 
and internal commas are required. For omitted items, the defaults are 


b 1 
e 99999.999 
i 1 


Note that in the case of a sequential read operation from a line file, the 
default value of i is not used. If i is omitted, the next line in the file 
is read; if i is specified as 1, then an increment of 1 is used. If the ¢ 
is omitted, an end-of-file indication is returned when the end of the file 
is reached. 


The line number range specifies a range of line numbers to be used for 
input or output. If it is used with a line file, the line numbers are taken 
froma the file. For sequential files or devices, they are generated by the 
system using the values given for b, e, and i. Thus for line file A, 


A (10,15) 


represents all lines in the file with line numbers between 10 and 15 
inclusive, and for tape *T*, 


*T* (1,322) 


represents 322 records read from or written to *T*, using line nuabers 1, 2, 
soe, 322- Note that on input the record following the one given by e¢ is 
also read and moved to the user prograa buffer. Therefore in the above 
example, the tape would be positioned after the 323ed record not the 322nd. 
Details on how the line number range affects the usage of an FDname is given 
below in the section "Types of File Organization". 
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CONCATERATION 


Although the maximum size of any single file is limited (depending on the 
type of organization of the file), the amount of data that may be referred 
to by a given FDname is effectively unlimited, because several files or 
devices may be automatically chained together (concatenated) either explic- 
itly or japlicitly. Explicit concatenation means the user explicitly 
indicates by the FDname how the files or devices are to be chained. 
Implicit: concatenation means that the contents of the file or device 
indicate’ how they are to be chained together. 


Zaplicit Concatenation 


Implicit concatenation is indicated as follows: 


SCONTINUESWITH FDname 
or 
SCONTINUESWITH FDnane RETURN 


(where e represents exactly one blank). Whenever such a line is read fron 
any file or device, reading continues with the file or device FDname and the 
*S$CONTINUE WITH® line is not passed as data to the pragram issuing the read 
operation. The "$CONTINUE WITH" line is, however, moved to the user progran 
buffer before the new data line is moved in. This may cause probleas in 
some programs if the "SCONTINUE WITH" line is longer than the next data 
line. 


In the first case (without the RETURN), reading continues with the 
specified FDname, and the lines following the "SCONTINUE WITH" line in the 
original file or device are ignored. This is analagous to a transfer 
statement in programming languages. The second case (with the RETURN) is 
analagous to a subroutine call in programming languages -~ after reaching 
the end of whatever it "“contintied with", reading resumes with the line 
following the "SCONTINUE WITH" in the original file or device. 


This implicit concatenation action can be disabled. (Otherwise, there 
would be no way to inspect a file to see if a "SCONTINUS WITH" line is 
there.) The Ic global switch, which has initial value ON, can be set with 
the $SET command or the subroutine CUINFO. The MTS command 

$SET IC=OFF 
turns off isplicit concatenation. In addition, the [/0 sodifier Ic 
overrides the setting of the IC global switch for all references to the 
FDname to which the sodifier is attached. Thus, 


$LIST PHYLE@~IC(LAST) 
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allows the user to see if the last line of PHYLE contains a "SCONTINUE WITH" 
line. 


Explicit Concatenation 


Several files and/or devices may be chained together by using explicit 
concatenation. This is done by giving the names of the files or devices 
(with optional modifiers and/or line number ranges) in the order desired, 
connected by plus signs. For example, 


-1 (1,100) #MYFILE 


specifies the contents of lines 1 through 100 of -T followed by the contents 
of MYFILE. Note that line 101 of file -T (if there is one) is also moved to 
the user program buffer, and is then replaced by the first line in MYFILE. 
In some programs (never in MTS commands like $COPY) this may cause probleas 
if the first line in MYPILE is shorter than line 101 in -T. 


If two or more consecutive simple FDnames in an explicit concatenation 
are identical, all but the first may be omitted. For example, 


A (1,1) +# (LAST) 
is identical to 
A (1,1) +A (LAST) 


If a member of an explicit concatenation uses implicit concatenation 
(that is, contains a "$CONTINUE WITH" line), the entire implicit concatena- 
tion is used as only that member of the explicit concatenation. The 
following members of the explicit concatenation are not ignored. Note that 
the FDname in the "$CONTINUE WITH" line may itself be an explicit 
concatenation. 


The processing of the next member of an explicit concatentaion is started 
whenever a return code of 4 (end-of-file or device) is received for a read 
or write operation (which occurs whenever the physical end is reached or the 
ending line number is exceeded). Care should be exercised when using 
indexed operations on explicitly concatenated files. For a sequential write 
operation, the line number range specifications may be used to control the 
flow of data into several files or devices. For example, 


SCOPY A B(1,10) +*SINK* (1, 10) +B(11) 


copies from file A, starting at line 1, 10 lines into file B, followed by 10 
lines to *SINK*, followed by the remainder of file A into file B, starting 
at line 11. The ending line number specified in the line number range for a 
simple FDname (or the last member of an explicit concatenation) is ignored 
when performing a sequential write operation. Thus, the command 
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SCOPY A(1) B 
is identical to 


SCOPY A(1) B(1,10) 


To copy only the first 10 lines from file A into file B, the user may give 
the command 


S$COPY A(1) B(1,10)+*DOMMY* 
Note that this is not the same as 
$COPY A(1,10) B 
since the line number range (1,10) can contain 0 to 10007 lines. 
Some examples of explicit concatenation are: 
MAIN+¢SUBR 
DATA (1, 1) (3,10) @UC 
*SOURCE*+DATA+ALLOC (1, 10) 
*TAPE* (1,10000) +* TAPE 2* 

Note that an explicit concatenation of a file or device name effectively 
specifies a new file name for the duration of the read or write operation. 
That is, the explicit concatenation 

MYSOU RCE+-DATAt*SOURCE* 
is effectively the name of a file consisting of the contents of the 


permanent file MYSOURCE, followed by the contents of the temporary file 
=-DATA, followed by the information on the pseudo-device *SOURCE*. 


PDNANES 


The term FDname is defined as either 


(1) a simple FDname with optional modifiers and/or a line number 
range, or 

(2) an explicit concatenation of two or more simple FDnames, each 
with optional sodifiers and/or line number ranges. 


In either case, the files or devices specified by the FDnames may contain 


"SCONTINUE WITH" lines. In the cases where a restriction nust be made to 
refer to a single file or device, the term FDname is not used. 
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ERROR _ PROCESSING 


If the FDname for a file or device is incorrect (such as containing an 
illegal modifier), an error comment is issued when the FDname is entered. 
If, however, the FDname is correct but the intended usage is not (such as 
trying to read from a file that does not exist), then the error condition 
does not occur until the first time an attempt is made to use the file or 
device. 


In either case, when the error condition is noted, error comments are 
printed as described below, and then 


(1) for batch jobs, a return is sade to MTS command or debug mode, and 
cards in the user's deck are skipped until an MTS command ($ in 
column 1) is found, or 

(2) for terminal usage, the line 


ENTER REPLACEMENT OR "CANCEL*®, 


is typed. At this point, the user nay either enter a replacement 
FDname (including the modifiers and/or line number ranges), or 
else enter the six letters CANCEL, in which case MTS returns to 
MTS command mode.? 


Error comments concerning simple FDnames are reported using the same fora 
of the FDname that was entered when the FDname was specified, including any 
modifiers or line nuaber ranges. If the FDname was specified as part of an 
explicit concatenation, it is preceded by "...#" (if it was not the first 
member) or followed by "+..." (if it was not the last member). Thus, the 
comment 


",.etAt..." DOES NOT EXIST 


means that the file "A" does not exist, that it was specified as part of an 
explicit concatenation, but it was neither the first nor the last member. 
If a replacement FDname is entered in response to one of these comments, it 
replaces the exact FDname typed out in the comment, in the same relative 
position in any explicit concatenation. Note that a full FDname sust be 
entered, including all line nusmber ranges and nodifiers desired. 


The three error messages that occur at "first usage" time are as follows: 


"“Foname"™ DOES NOT EXIST, means that FDname was interpreted as a file 
name and no file by that name exists. 


"FDOname* IS NOT AVAILABLE. means that FDnage is an existing file, but it 
cannot be accessed at the present tise (pro=- 


tNote that if the replacement is a file named CANCEL, then the user sust 
enter it as “#CANCEL" -- i.e., prefixing it with the "#" file nare 
character. 
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bably because it is on a volume that is not 
available). 


"PDname" IS INVALID. is produced in all other cases. This message 
is preceded by an earlier message giving the 
exact error. 


As an example, consider the following piece of a terminal session. Input 
from the user is in lower-case letters; output from the computer is in 
upper-case. The numbers in brackets at the right are for reference only. 


fcopy *source* -adsnark (1] 
#ILLEGAL FDNAME MODIFIER { 2] 
>line one {3] 
>"\A@SNARK" IS INVALID. (4] 
>ENTER REPLACEMENT OR "CANCEL", (5] 
?cancel ( 6] 
# (7) 


In [1], the user enters a copy command with an illegal modifier. The error 
message is printed immediately [2]. However, the error occurred in the 
second FDname of the COPY command, which was not referred to until after the 
first line is read from *SOURCE* in [3]. At that point, the illegal name is 
first used, and the “first usage" error message is printed [4], and then the 
user is prompted for replacement (5]. In [6], the user enters CANCEL, which 
causes return to MTS command mode ("#" prefix character) in [7]. 


USAGE_OF_FDNAMES 


There are two types of input/output that a program can do. In the sore 
common case, the program may read or write information, without caring where 
it's coming from or going to. This case is handled with logical I/0 units. 
In the other case, the program reads or writes on a specific file or device, 
whose name is either built into the program or is obtained as data from the 
user. This case is handled with FDUB pointers. 


Logical I70 Units 


When a program is coded, the file or device name to be used for the 
program's data may be unknown, so that it is impossible to specify it when 
the program is translated. Even if this information were known, it would be 
inconvenient to specify it during translation, since this would require 
retranslation every time the file or device name was changed. Thus, it is 
desirable to specify the location of the data at execution time rather than 
at translation time. To do this, a loqjcal 1/0 unit is used. A logical 1/0 
unit is a syabolic name which is used in a prograa to specify the source of 
data for input or the destination of output information. A logical I/O unit 
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does not name a specific file or device; it simply serves as a reference. 
When a program is executed, it is necessary to first specify, for each 
logical 1/0 unit used by the program, the actual file or device to be used. 
For example, in FORTRAN, the statement 


READ (5,100) P 


requests input from logical I/O anit 5. Before this statement can be 
executed, the user must specify a file or device name to be used whenever 
logical I/O unit 5 is referenced. Thus, in the SRUN command to execute this 
program, the user must specify the keyword "5=FDname" to indicate that when 
"5" is referenced, "FDname"* should be used. For example, if the translated 
program is in the file OBJECT, then when the command 


$RUN OBJECT 5=INFYLE 


causes the program to be executed, the program reads from unit 5 which 
specifies the file INFYLE. 


The names of the logical I/O units are: 


0 through 19 (integers) 
SCARDS 

SPRINT 

SPUNCH 

SERCOM 

GUSER 


Por each of these, except 0 through 19 , there is a subroutine of the same 
name (described in Volume 3) to do input and/or output on this unit. For 0 
through 19 , the subroutines READ and WRITE are provided. These subroutines 
can be called from both assembly language programs and FORTRAN programs. 
For example, calling the subroutine SCARDS from a program causes a record to 
be read from the logical I/0 unit SCARDS. 


Default Values for Logical 1/70 Units 


Since it is convenient to reduce the amount of typing necessary to 
specify the information required on a $RUN command, some of the logical I/0 
units have default specifications, These are assignments of pseudo~device 


names to the logical I/O units if no assignments are provided on the SRUN 
command. 
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Unit { Default 


{ ( | 
{ SCARDS {| *SOURCE* { 
{ SPRINT {| *SINK* { 
1] SPUNCH {| *PUNCH* { 
{ SERCOM { *MSINK* i 
{| GUSER { ‘*MSOURCE* | 
{ 0-19 } none { 
j { { 


For example, if on a $RUN command, the logical 1/0 unit SCARDS is not 
specified as a particular file or device, then it is by default assigned to 
the current input *SOURCE*. Since most of the translators in MTS use SCARDS 
for source program input and SPRINT for compilation listing output, it is 
often unnecessary to specify these logical 1/0 units when running the 
translators, especially in batch mode. For both batch and terainal use, it 
is usually necessary to specify the logical I/o unit for the translator 
output of the resulting object deck. Logical I/O units 0 through 19 have no 
default specifications in MTS. There are, however, default specifications 
for the equivalent data-set reference nuabers within the FORTRAN IV I/0 
routines during program execution (see the Fortran User's Guide in Voluse 
6). 


ERUB=pojnters 


It is occasionally necessary for a program to read or write on a specific 
file or device. The FDnarme say be built into the program (as for example a 
fixed file of error messages) or may be input data to the prograr. the 
program uses a fullword quantity called a EDUBcpointer to refer to this 
PDname when doing input or output on the file or device. A FDUB-pointer is 
the location of a File or Device Usage Block, maintained by MTS to control 
the usage of that file or device. 


A PDUB-pointer is obtained by calling the subroutine G2ZTFD (see Volume 3) 
giving it the FDname for the file or device. The FDUB-pointer returned by 
GETFD can then be used in calls to READ or WRITE to do input or output. It 
can also be used in calls on a number of other subroutines (see table 
below). When the program is finished with the FDUB-pointer, the FDUB can be 
released by calling the subroutine PREEFD. 
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ee ee N 


{ Subroutine | Purpose { 
i \ { 
] GETFD { To get a FDUBepointer for a given FDname 1 
( | ! 
_—_—_——_____—_—_+- 
1 \ { 
{ READ { To perform an input operation { 
{ WRITE {| To perform an output operation ( 
I ! l 


{ | | 
{ CHKFDUB { To check an FDUB pointer for validity { 
( CONTROL { To issue control commands to certain types of | 
| | files and devices | 
{ EMPTY { To empty a file | 
| GDINF { To get information about a file or device { 
{ GDINFO | To get infcrmation about a file or device { 
] GFINF { To get information about a file { 
{ NOTE { To return position information for a sequen- | 
{ {| tial file ( 
{ POINT 1 To position a sequential file H 
| REWIND # { To rewind a file or device { 
{ SETAFD { To make a file active { 
t SKIP 1 To position magnetic tape files and devices { 
( I { 


FREEFD { To release a FDUB-pointer 


Subroutines using FDUB-pointers 


Detailed information about the above subroutines is given in Volume 3. 
There are several other subroutines (such as CREATE and DESTROY) which take 
the name as a parameter. These are also described in Volume 3. 


TYPES_OF FILE ORGANIZATION 


The three types of file organization are 
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SSS ee Ee ee ee ee 


Line file (default) 


SEQWL Sequentialewith-line-nuabers file 


{ 
{ 
j 
SEQ { Sequential file 
{ 
| 
{ 


a ieceetserne we errenee-eperenallesoseemne-earneaeenestpmnly an ire rr an rrceesguansonstasininnsmnnsnaenssramnrcanvessrsaterenel 


The file organization can be specified as the value of the TYPE keyword on 
the SCREATE command when the file is created. For example, 


SCREATE SP TYPE=SEQ 


creates "SF" as a sequential file. Note that since the default is LINE, all 
temporary files that are iaplicitly created (by the first usage of the file) 
are line files. If a different type is wanted, the temporary file aust be 
explicitly created using the SCREATE command. 


The SEQWL type is really a variation of the SEQ type; hence in the 
following discussion of line files versus sequential files, what is said for 
sequential files also applies to sequential-with~line-number files. 


Line Files 


The basic MTS file type is LINE. A line file is an ordered set of zero 
or more lines. Each line consists of 1 to 255 characters (bytes). Each 
line has associated with it a unique line nuaber (for that file) which is 
not part of the line. The lines in the file are numerically ordered. An 
exact definition of line nuabers is given below; for the discussion here, it 
is a number from -99999.999 to 99999.999 inclusive. Note that while the 
line number for each line aust be stored in the file, the line number is not 
part of the content of the line. 


By using its line number, any line in the file may be directly accessed, 
either for reading or writing. An input or output operation on a file which 
explicitly indicates a specific line to be read or written is called an 
indexed operation. The more coason input/output operations ona file 
specify a line nuaber at which to begin reading or writing, and continue 
with the "next" line for successive records read or written. These are 
called geqyential operations. These two methods say be intermixed, for 
exaaple, using an indexed read operation to get to a given position in a 
file and then reading sequentially from there. 


The type of operation used depends on the sequential/indexed modifier 
bits supplied for each FDname or input/output subroutine call. If, in the 
call on a subroutine, the modifier word supplied has the indexed bit set, or 
if @I was appended to the FDname when it was given, then an indexed 
input/output operation is performed. The default operation is sequential. 
(See Appendix A for the description of the modifier amalgamation process.) 
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Indexed Operations 


When an indexed read or write operation is done, the line nuaber 
given in the I/0 subroutine call is used to specify the line to he 
accessed. A return code of 4 (end-of-file) occurs if there is no line 
in the file with that line nuaber, or if the line number is outside the 
line number range given with the FPdname. (The beginning and ending 
line numbers, if not specified explicitly in a line number range, 
default to 1 and 99999,999, respectively.) 


Implicit and explicit concatentation with an indexed operation are 
handled in the following manner: 


For an indexed read operation, if the line selected is a 
"SCONTINUE WITH" line and implicit concatenation is enabled (the 
default case), then concatenation occurs and the same line number 
is selected for the new file or device specified by the FDnasze in 
the "$CONTINUE WITH" line. 


If the file is part of an explicit concatenation (and not the last 
member) and a condition that would normally produce a return code 
of 4 occurs, a transfer to the next member in the concatenation 
occurs instead. Thus, a return code of 4 on an indexed read to a 
concatenation indicates that none of the members of the concatena- 
tion had a line of that number; a successful indexed read ona 
concatenation selects the specified line from the first member of 
the concatenation (starting with the current member) with that 
line number. 


Sequential Operations 
When a line file is written or read with an indexed operation, the 
line number is explicitly given. However, for sequential operations on 
a line file, the question of the beginning and ending line numbers 
arises. These are specified via the line number range (discussed 
earlier) which has the fora 
(b,e,i) 


where b, e, and i are each line numbers as described below. 


For a read operation, the beginning line number is b (which defaults 
to 1, if not given) and the ending line number is e (which defaults to 
99999.999, if not given). If the increment i is not explicitly given, 
it is not used. Thus 

A 
is identical to 


A (1,99999.999) 
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and specifies al] lines with numbers between 1 and 99999.999 inclusive. 
If, however, the increment i is explicitly given, then it is used to 
select the next line. Thus 


A(ee1) 
is identical to 


A(1,99999.999, 1) 


and specifies only the lines with integer line numbers from 1 through 
99999 inclusive. 


For a write operation, the beginning line number is b (which 
defaults to 1, if not given) and the increzent is j ( which defaults to 
1, if not given). The first line written has line number b, the second 
bei, and so on. 


Note that b may be greater thane, and that i say be negative. 
Thus, reading fror 


A(LAST,1,7°1) 


reads the integer-nurmbered lines of A in reverse order (if LAST is 
integer-valued). 


Mixed Operations 


Line 


128 


The following discussion applies to mixed sequential and indexed 
operations on the same logical I/O unit or FDUB-pointer. Accesses to 
the same file via other logical I/O units or other FDUB-pointers are 
independent. 


An indexed read or write operation operates on the line specified by 
the line number parameter in the I/O subroutine call, regardless of the 
previous I/0 operation. 


If the first operation on a file is sequential, the behavior is as 
described above: the line is specified by the beginning line number b. 


For a sequential operation that is not the first operation, the 
"next" line is chosen. For a read without an explicit increment, 
"next" is the next line in the file after the last one read or written. 
For a read operation with an explicit increment, the "next" line has 
the line number of the last line read plus the first multiple of the 
increment for which there is a line. For a write operation with an 
explicit increment, the “next" line has the line number of the last 
line written plus the increnent. 


Suabers 
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Externally, a line number is one of three forms; 
(4) tnnnpa.nnan 


where "n" is a decimal digit (0 through 9). The mininunm and 
Maximum line numbers are therefore -99999.999 and 99999.999. 
When writing a line number, leading plus signs and leading 
zeros, trailing decimal points, and trailing zeros after 
decimal points may be omitted. Examples of line nuabers of 
this form are: 


5 5.1 5.13 5.137 32505. 137 =32505.137 
(2) LAST 


which has the value of the last (algebraically greatest) line 
number in the file. If the file is empty, the value is zero. 


(3) LAST+n 


where "tm" is a number of the form “tnonnnan.nnn" as described 
above. The value of this is the algebraic sum or difference of 
the two components; thus LAST=1 does not necessarily specify 
the line number of the next-to-last line, but serely a line 
number 1 less than that of the last line. 


The internal form of a line number is a fullword binary integer 
whose value is 1000 times the external form. Thus, a line number whose 
external form is 1 is stored internally as 1000 (decimal) or 00000358 
(hex). The internal form of a line number sgust be supplied to the 
input/output subroutines when requesting an indexed operation, and the 
internal form of the line number of the line that was read is returned 
after a sequential read (or a sequential write in the case that the 
RETURNLINE# modifier was specified -=- see the Appendix A modifier 
description). 


A sequential file is an ordered set of zero or amore lines. Each line 
consists of 1 to 32767 characters (bytes). The lines of a sequential file 
do not have line numbers and cannot be directly referred to by line number 
from a program or command. 


As the name implies, sequential files can only be read or written 
sequentially. A read operation always gets the next line, starting with the 
first line (only), while a write operation always adds the new line at the 
end of the sequential file. 


Line number ranges may generally not be specified for a sequential file. 
For reading, b and e may ‘be specified, but the b must be 1, for example, 
A(1,99). For writing, line number ranges may not be specified since a 
seguential write always adds to the end of the file. 
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Sequential files generally may only be modified by adding lines at the 
end of the file, and by emptying or destroying the file. By the use of the 
KROTE and POINT subroutines, it is possible to "remember" positions when 
reading or writing a sequential file, and then later reposition to begin 
reading (or writing) at one of these positions. Positioning to a particular 
record in a sequential file and then issuing a write causes the file to be 
truncated at the point after the record was written. However, positioning 
to a particular record in a sequential file and then using a write with the 
@SP modifier replaces that record with one the same size, and does not 
otherwise affect the file. Details on the use of the subroutines NOTE and 
POINT and the @SP modifier on write operations to sequential files are found 
in Appendix B. 


Usage of Sequential Files 


Sequential files may be used whenever the file is read or written 
sequentially. Sequential files, line files, and devices can be 
intermixed by implicit and explicit concatenation. 


An attempt to do an indexed operation on a sequential file, or an 
attempt to do a sequential operation starting at other than line 1 
causes an error message to be generated. This message is controlled by 
the SEQFCHK global switch. Issuing the comnmand 


S$SET SEQFCHK=OFF 


disables this check, and the input or output operations are done as 
though they had been sequential operations starting at line 1. See the 
section "Putting Information in a File" below. 


Sequential files, although sore restrictive in usage than line 
files, can be larger than line files and are nore efficient to access. 
They are, therefore, preferred where only sequential operations are 
planned. 


Magnetic tape users should realize that sequential files are very 
similar to tape files, and thus most applications which use tapes could 
use sequential files with slight modifications. Such operations as 
forward spacing files and the writing of end-of-file marks do not have 
meaning with sequential files. Files cannot be rewound by writing the 
three character record "REW" into the file using the @CC modifier. The 
subroutine REWIND should always be called to rewind a file (it also 
revinds tapes). Finally, it should be noted that blocking of records 
(i.e., packing of short records into fewer, longer records) is not 
nearly as space-saving on a sequential file as on a tape file since 
there are no "gaps" between logical records in a sequential file. 
However, blocking does improve the efficiency of using sequential 
files, since the input/output overhead is reduced. 
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Sequential-with-line-numbers Files 


The sequentialewith-line-numbers file (SEQWL) variant of a sequen- 
tial file is designed to save a line file together with its line 
numbers, This file then can be restored later to a line file with the 
same line numbers as the original file. The line numbers are only 
retained as part of the file so that the information in the file can be 
transferred later to a line file. The line numbers cannot be referred 
to while they are "frozen" in the sequential file. 


If LNF is a line file and SWF is a _ sequentiale-with-line-nuabers 
file, then (assuming SWF is empty and LNF has no lines with line 
numbers less than 1) 


SCOPY LNF SWFat 
saves the line file with its line numbers in SWF, and 


SEMPTY LNF 
SCOPY SWF LNF@at 


restores that information into LNF, with exactly the same line nuabers 
it had originally. Note that the indexed modifier is necessary on the 
second PDname of both COPY commands to prevent new line numbers from 
being generated. 


The lines in a _ sequential-with-line-nuabers file must have line 
numbers that are in increasing order. When adding new lines to a_ file 
of this type, it is necessary to insure that each line added has a line 
number greater than the last one saved in that file. If @I is not 
specified, causing new line numbers to be generated rather than the 
original ones being used, then LAST+1 can be specified on the file. 
Thus for example if SWF (as above) is not empty, then 


SCOPY A SWF(LAST+1) 


adds the lines from A to the end of SWF. 


. CREATING FILES 


The availability, organization, and size of a file are all established at 
the time the file is created. Files are created by using the SCREATE 
command or by calling the CREATE subroutine from a program. The syntax of 
the SCREATE command is given in the command description. The CREATE 
subroutine is described in Volume 3. The following discussion covers the 
specification of the file characteristics when asing the $CREATE command. 


The SCREATE command has the basic fora: 
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SCREATE filenane 


which causes a file of this name to be created (unless there already exists 
a file of the same name, or the user has exceeded his file space allotment). 
There are several options which can be specified in the form of keyword 
expressions. 


SIZE=#n h is nuaber of average (40 byte) lines 
SIZE=nP n is number of pages (1 page = 4096 bytes) 
SIZE=nT n is number of 2314 tracks (one 2314 track = 7294 bytes) 


For most files, this parameter is not needed. The default size for 
permanent line files is the smallest possible (one 2314 track) which is 
enough for about 90 average lines. Since files expand automatically when 
possible up to 16 times, most data sets can fit into a file of default size. 
(As a matter of interest, about 40% of all user files in the system are 
one-track files, and about 20% are two-track files.) The following table 
gives the default sizes: 


] Permanent 11 Temporary { 


ore 
{ Line | Sequential |{{ Line { Sequential | 


{ Amount { 1 | 1 i § | 5 1 
{ of Space { 2314 | 2314 {i 2378 | 2314 { 
{ Allocated { track | track {{ tracks | track j 
pe eet 
j Pages 1 2 { 2 tH 9 { 9 { 
| Charged 1 ] Vi (- { 
“me ‘ ms i aa 1. ; 


For larger files, it is necessary to specify an estisated size. then 
estimating size in terms of pages (or tracks), it should be noted that there 
is a certain minimus overhead for each line or logical record in the file. 
These overheads are as follows: : 


a Sans 
{ Type { Min. Overhead { 
' ' oa 4 
{ LINE | 8 bytes/line | 
{ SEQ { 6 bytes/line || 
{ SEQWL | 10 bytes/line | 


Cen cnreiesiisendainateredlainnctiintnicnnenenmdnsmaninisnissvinenininiminmviniicell 


Inforaation on the internal structure of files and approxisate formulas for 
the size required for a file is found in Appendix C.. 


Piles are extended automatically when possible by the system. the 
conditions for automatic expansion are: 
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(1) The user has not exceeded his disk space allocation. 

(2) Space is available on the direct-access volume on which the file 
was originally created. 

(3) The file consists of no more than 16 distinct allocations (called 
"extents"). 


If any of the above three conditions is not met, the error comment 
FILE "filename"; SIZE EXCEEDED 


is printed. A line file expands each time by the amount of the initial 
request or 7 tracks, whichever is less, up to an absolute maximum size of 
109 tracks. A sequential file expands each time by an amount equal to the 
initial request (unless there is not a large enough extent available on that 
volume, in which case a smaller extent is taken) up to an absolute smaxinuna 
size which is one disk pack (4000 tracks; 7294 bytes/track). 


TYPE=LINE Line File (default) 
TYPE=SEQ Sequential File 
TYPE=SEQWL Sequentiale-with-line-nunbers File 


This specifies the organization of the file being created. 


PUTTING INFOR TON Q FILE 


There are basically two different methods to initially put a set of lines 
from *SOURCE* into a file. The following descriptions are equally applice- 
able to batch and terminal usage. 


The first method to put lines into a file is to establish the file as the 
active file, either with the $GET command (if it already exists) or with the 
$CREATE command (if it does not exist), and then turn on automatic line 
numbering. In the examples below, F is a line file or a sequential-with- 
linee-nuambers file. 


$GET F 

SNUMBER 
e 
*® lines to be put in file 
e 

SUNNUMBER 

SPELEASE 


If F is a sequential file, then the SEQFCHK global switch must be disabled. 
$GET F 


SSET SEQFCHK=OFF 
SNUMBER 
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e lines to be put in file 
e . 
SUNNNUMBER 

SRELEASE 


The other method is to use a SCOPY command, copying from the source 
stream *SOURCE* into the file, as for example: 


SCOPY *SOURCE* F 


e 
*® lines to be put in file 


e 
{end-of-file signal} 


where the end-of-file signal in batch must be a "SENDFILE* delimiter (or the 
physical end of the card deck), or from a terminal, it can be either an 
end-of-file control character for that terminal or a “$ENDFILE*". 


These two methods are not quite equivalent in behavior. The differences 
are that in the first case, lines are being read in MTS command mode, and in 
the second case are being read in copy aode,. (See the “System Command 
Language" section of this manual for a description of the various nodes.) 


In the copy mode aethod (the second case), all lines are transaitted into 
the file as typed except the first line consisting of "SENDFILE", which is 
recognized as an end-of-file delimiter and terminates the copy operation. 
In order to get "S$ENDPILE" lines into the file, the command 


SSET ENDFILE=NEVER 


should be issued before the SCOPY command is issued, causing the "SENDFILE*" 
lines to be treated only as data lines. This means however, that “SENDFILE“ 
cannot be used to terminate the copy. If this is being done from a 
terminal, an end-of-file control character must be used to terminate the 
copy. But if this is being done in batch, then the COPY command aust be the 
last command in the deck, because all the remaining cards of the deck are 
copied into the file. 


Note that implicit concatenation is normally enabled. If a 
N$CONTINUE WITH" line is to be copied rather than taking effect, implicit 
concatenation aust be disabled for the copy, as for example: 

SCOPY *SOURCE*@-IC F 


On the other hand, if implicit concatenation is enabled, a line consisting 
of 


SCONTINUE WITH *DUMMNY* 


produces an end-of-file condition in both batch and terminal usage and can 
be used to terrminate the copy. 
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In the MTS command mode method (the first case), there are two 
differences: 


(1) If the last character of an input line (column 80 of the card, if 
in batch) contains a continuation character (default is "=-"), then 
the following line is appended to the end of the current line 
(after removing the continuation character). The value of the 
continuation character (CONTCHAR) can be changed by the SSET 
command or the subroutine CUINFO. 

(2) If -a line beginning with a dollar sign is to be put into the file, 
it must be typed beginning with two dollar signs. The first is 
removed before it is transmitted to the file. (Lines with one "$" 
are treated as immediate commands or deliniters.) 


a ae ee eee: 


There are two basic methods of making changes to a file: using the MTS 
commands to make changes to the file on a line=by-line basis, or using the 
context editor to make changes either on a line basis or on a context basis. 


Changes Using MTS Commands 


MTS commands can be used to change one line of a line file, a group of 
lines of a line file, or to empty or destroy an entire file. Sequential 
files can be changed only by adding to the end of the file, or by emptying 
or destroying the file. Single lines or groups of lines in a line file can 
be changed using the same basic two methods that were used to put 
information in a file. Entering a $GET command for the file makes it the 
active file. Then entering a line prefixed by the line number causes that 
line to be entered into the file with that line number. If there already 
was a line with that number in the file, it is replaced by the new line. 
Thus, 


SGET A 
121.3XYZ 


puts XYZ in as line 121.3 of file A. If there already was a line numbered 
121.3, it is replaced. Entering a null line (line number immediately 
followed by an end-of-line character) deletes the line with that number in 
the file. 


When the user is entering lines into the active file in MTS command sode, 
he enters a line number immediately followed by the contents of the line 
(assuming automatic line numbering is off). The first character following 
the line number is the first character of the line. The end of the line 
number is determined as follows: 
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(1) An alphabetic character terminates the number. 

(2) The second occurrence of "." terminates the number. (The first 
occurrence is the decimal point.) 

(3) A “+ or "=" which is not the first input character terminates the 
nuaber. 

(9) A blank terminates the line number. 

(5) Any other special character terminates the line number. 


If the character terminating the line number is the Line-nyaber-se 
character (initially a comma), then this character is used only as a 
separator and is not part of the line number or the line. For exaaple, to 
put the three characters "123" in as line 6 of a file, 


6,123 


would be typed. The Line-nuaber-separator character (LNS) may be changed by 
the SSET comaand or the subroutine CUINFO. 


The $COPY command can be used to copy lines or groups of lines from a 
file to itself or another file. Thus 


SCOPY A+B C 
puts the contents of A, followed by the contents of B, into file Cc (or if C 
is sequential, adds to the end of C). If either A or B are line files, then 
the "contents" are only the lines with numbers between 1 and 99999.999, 
which is not necessarily the entire contents of the file. If C is a line 
file, lines that are not replaced by the copy operation are not affected. 
SCOPY A(1,5)+(99,99)+(1000) B 
copies from A lines 1 through 5, 99, and 1000 through the end of A into B, 
starting at line 1 in B, if B is a line file, or adding to the end of B, if 
B is sequential. File A must be a line file in this example. Note that if 
the example were 
SCOPY A(1,5) B 
then A could be either a line file or a sequential file. 
SCOPY Aa(10,15) A(100) 
makes a copy in A of the lines in the range of 10 through 15, starting at 
line 100.. Remember that the range of 10 through 15 is the same as 10.000 
through 15.000 and can contain anywhere from 0 to 5001 lines. The increment 
between the copied lines starting at line 100 is 1 (the default). 


A copy operation from a file to itself specifying overlapping line number 
ranges can be done, but should be used with care. 


SCOPY A(1,9) A(2) 
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results in line 1 being repeated in lines 2 through 10, since line 1 is 
copied into line 2, and then line 2 (which is now a copy of line 1) is 
copied into line 3, and so forth. 


Once a file has been created, it way be emptied or destroyed at any tine. 
This applies both to permanent files and to temporary files, Permanent 
files exist until the user destroys thea; temporary files exist until the 
user destroys them or until he issues a $SIGNOFF command (or its equiva- 
lent), whichever cones first. 


To empty a file, the command 
SEMPTY filename 
should be issued. This causes the contents of the file to be discarded, but 
all storage space allocations for the file are preserved. Future references 
to the file reuse the file space. If the command is issued froa a terninal, 
the user is asked to confirma that he really wants to get rid of the contents 
of the file. The message is 
FILE "filename" IS TO BE EMPTIED. PLEASE CONFIRM. 

The user should respond with "OK", "O0.K.", or "!" to empty the file. Any 
other response cancels the command. Confirmation is not requested for 
temporary files, nor for any files in batch runs. 

It should be noted that the SEMPTY command empties the whole file; parts 
of a file cannot be enaptied by attaching a line number range to the file 
name in the command. Thus 

SEMPTY A(10,50) 
is identical to 
SEMPTY A 
and empties all of file A. To partially empty a file, the parts to be saved 
should be copied to another file, the file should be eaptied, and the saved 
parts should be copied back to the original file. 
To destroy a file, the command 
SDESTROY filenane 
should be issued. This causes all space allocated for this file to be 
released. If this command is issued from a terminal, confirmation is 
requested: 
FILE "filename" IS TO BE DESTROYED. PLEASE CONFIRM. 
The user should respond with "OK", "0.K.", or "!" to destroy the file; any 


other response cancels the command. Confirrjation- is not requested for 
teaporary files, nor for any files in batch runs. ; 
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In conversational rode, no confirmation request is issued when a file is 
to be emptied or destroyed if the confirmation is provided on the cormsand 
line. For example, the sequence issued in conversational mode: 


SEMPTY filename OK 
SDESTROY filenanme2 OK 


exnpties "filenanet" and destroys “filenane2" without requesting . 
confirmation. 


Changes Using the Context Editor 


The context editor can be used to edit line files , by lines or groups of 
lines. It can also be used on a context basis, scanning for lines with 
certain character strings in thea, replacing characters in a line with other 
characters, and so on. Por example, on a line-nurmber basis, the following 
replaces line 2, deletes line 7, and inserts two lines after line 8 of the 
file being edited (the first character is the prefix character; input from 
the user is in lower-case, editor output is in upper-cage): 


sreplace 2 ‘new second line! 
: 2 NEW SECOND LINE 
:delete 7 
tinsert 8 
?eighth and a quarter 
?eighth and a half 

hull line input=-> ? 


On a context basis, the following example scans through the file looking for 
the characters "ABC#D*": 

tscan /file ‘abc#d' 
and then the following command changes "C#D" to "XYZ"; 

schange ‘c#d‘*xyz* 

The editor is invoked in MTS command mode with the SEDIT command, and has 

its own set of sub-comaands. Full details on using the context editor are 
given in the "Edit Mode* section of the "System Command Language" section in 


this volume. 


The context editor can only be used on line files at present. 


Restoring the Contents of a File 


Often a user makes changes to a file and then wishes he hadn't. The user 
should realize that the context editor makes changes to a file as the 
commands are entered; it does not sake changes to a working copy. Thus, it 
is prudent to either make a copy of the file as a backup before starting to 
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edit it, or else to use the editor's checkpoint/restore facility. The 
CHECKPOINT edit command tells the editor to remember the contents of the 
file at the time the command was entered. The RESTORE command then allows 
the user to restore all or parts of the file to the state it was when 
checkpointed. See the "Edit Mode" section of the "System Command Language" 
for details. 


Recovery of a file that has been accidentally changed on a large scale 
(including its accidental emptying or destruction) can often be rectified by 
having the file restored to the condition it was in when files were saved on 
the previous night. The CDPC does a "file-save" at about three to five 
a.m. on Monday thru Thursday and on Saturday. A file can be restored to its 
state as of the file-save for any night of the preceding week, or its state 
as of the Saturday file-save for any of the preceding three weeks. There is 
a five dollar charge for restoring a file. Details on how to have a file 
restored are given in the “File-Restoring Service" section of Facilities and 


Services of WSU Computing and Data Processing Center for Academic Users. 


Often a user, after extensively working on a file, ends up with a 
"current" copy and an “original" copy, and would like to know how they 
differ. In particular, he would like a list of changes that must be applied 
to the original copy to make it into a current copy. 


There are three programs available in MTS public files that produce 
“changes" in this manner: *DOWNDATE, *0UNEDIT, and *AMENDS. All three 
differ on either the basis for deciding if something is changed, or the 
method of presenting the changes, or both. The rest of this. section 
presents examples showing how they differ. Details on use are found in 
Volume 2. 


The program in *DOWNDATE produces *UPDATE control cards as output. The 
current and original copies are read sequentially, and may be magnetic tape 
files, sequential direct-access files, or line files. All line numbers are 
ignored. The two copies are assumed to contain 80 character logical 
records. Only the first 72 columns of each record are compared; colusans 73 
through 80 are assumed to contain sequence-ID's. For example, if the 
original and current copies are as follows (assuming the sequence-ID begins 
in column 73): 


original: FIRST SEQIDO01 
SECOND SEQID002 
THIRD SEQIDO003 
FOURTH SEQIDO04 
FIFTH SEQIDO0S 
SIXTH SEQIDO06 
SEVENTH SEQID007 
EIGHTH . SEQIDO08 
NINTH SEQID009 
TENTH SEQIDO10 
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current: : FIRST 
NEW SECOND 
THIRD 
FOURTH 
FIFTH 
SIXTH 
EIGHTH 
EIGHTH AND A QUARTER 
EIGHTH AND A HALF 
NINTH 
TENTH 


Then 
SRUN *DOWNDATE SPUNCH=CHANGES 


and specifying “original” when it asks for “old source" and "current" when 
it asks for “new source" yields as content of CHANGES: 


SBEFORE *SEQIDO002°* 

NEW SECOND 

SDELETE *SEQTDOO2' 

RBEPORE *SEQIDOO7! 

EIGHTH 

EIGHTH AND A QUARTER 

EIGHTH AND A HALF 

SDELETE *SEQIDOO7* ‘SEQIDOOS* 
SBEFORE FILEMARK 


which is correct, although not a siniaua set of UPDATE commands. 
Specifying: 


SRUN *UPDATE. 

SINPUT original 
SOUTPUT new 

SCONTINUE WITH CHANGES 


makes new into a “current"™ copy. 


The program in *UNEDIT uses the same comparison algorithm as DOWNDATE but 
puts out context editor control cards. Both the current and the original 
copies. aust be in line files. The entire contents of the lines are 
compared. The line numbers are used for the edit control card output, but 
are ignored in the comparing process. Thus, the effect of applying the 
output of UNEDIT as commands to the context editor working on the original 
produces, as a result, a file with lines that have the same content as the 
"current" copy and in the same order, but not necessarily with the same line 
nurmbers. Given the following example, with “original” and "current" similar 
as before: 


line nusber contents 


original: T FIRST 
2 SECOND 
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3 THIRD 
4 FOURTH 
5 FIFTH 
6 SIXTH 
7 SEVENTH 
8 EIGHTH 
9 NINTH 
10 TENTH 
current: 1 FIRST 
2 NEW SECOND 
3 THIRD 
4 FOURTH 
5 FIFTH 
6 SIXTH 
8 EIGHTH 
8.25 EIGHTH AND A QUARTER 
8.5 EIGHTH AND A HALF 
9 NINTH 
10 TENTH 
Then 


S$RUN *UNEDIT O=original t=current SPUNCH=CHANGES 


yields as contents of CHANGES: 


so that 


DELETE 2 
INSERT 1 
NEW SECOND 
SENDFILE 

DELETE 7 
INSERT 6 
EIGTHTH 

EIGHTH AND A HALF 
SENDFILE 


$SET ENDFILF=ON 
$EDIT original 
SCONTINUE WITH CHANGES 


produces a “current" copy. 


The 


in comparing lines. 
and deletions. 


program in *AMENDS considers the line numbers as well as the content 
Its output consists of MTS command mode line insertions 
Thus, using the same “original" and "current" 


the UNEDIT example above, 


SRUN *AMENDS =original l=current SPUNCH=CHANGES 
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results in the following content of CHANGES: 


SNUMBER 2 1 
NEW SECOND 

SUNNUMBER 

7 

SNUMBER 8.25 .25 


EIGHTH AND A QUARTER 
EIGHTH AND A HALF 


so that 


SGET original 
SSOURCE CHANGES 


results in "original" being converted into "current" 


SHARED_FILES 


{The current facilities for sharing files between users are a ninimal 
interim version. This section will be replaced when the full sharing 
capability is installed in the systen. ] 


When a file is first created, the owner (the signon id under which the 
file was created) has unlimited access to it and all other users have no 
access to it. However, if the owner wishes, he can share the file, making 
various levels of access available to various categories of users. Shared 
files are referenced by prefixing the file name with the owner's signon id 
and a colon. For example, ABCD:XYZ is the file XYZ belonging to user ABCD. 
Sharing a file requires the use of the SPERMIT command. In order to specify 
a "permission", a valid access type must be stated. The access type tells 
who is allowed access to the file and what type of access is allowed. 


The six possible parameters of the SPERMIT command are "ALL", “CNW", 
“NOHE", "PRINO®, "RO", and "RUN". The “ALL access type allows other users 
to read the file in any way. It may be listed, copied, run, loaded, and so 
on. To specify the "ALL" access, the command 


SPERMIT filename ALL 


should be used. The user is still allowed to alter the file when the access 
code is “ALL". Problems may arise when another user is reading the owner's 
file at the same time the owner eapties the file. "cannot write" access 
("CNW") prevents the owner frem writing into the file. (Under no circums- 
tances can one user write into another user's file.) To specify the "cannot 
write" access, the command 


$PERMIT filename CNW 
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should be used. "CNW" access is useful in that it prevents the owner fro 
accidentally altering or emptying a file (although it may still be 
destroyed). Other users are not allowed to read the file by this access 
type alone. This is the only access allowed for temporary files. "PRJNO*“ 
like "ALL" specifies which users are allowed access to the file. When a 
file is given "“PRJNO" ("project") access, only those users with the sane 
project number are allowed access. To specify "project" access, the command 


SPERMIT filename PRJNO 


should be used. In order for another user with the same project number to 
access the file, that user must first copy the file using the *COPY prograa. 
(See MTS VOLUME 2, Public File Descriptions for details.) user XXXX owns 
file HISFILE with PRJNO access type and another user with an identical 
project number wants to copy the file to -MYFILECOPY, the appropriate 


command would be: 
$RON *COPY SPUNCH=<MYFILECOPY PAR=XXXX:HISFILE 


To allow a file to be run, or loaded, but not copied, listed, or read by 
any program other than the dynamic loader, the command 


$PERMIT filename RUN 
should be used. 


The last two parameters are "RO" (read-only) and "NONE". Specifying "RO" 
has the same effect as CNW and ALL together, that is, it allows all users to 
read the file and allows no one, including the owner, to write into it. 
Specifying “NONE” removes all access information allowing unlimited access 
by the owner and no access by anyone else (the same as when the file was 
created). If no access type is given on the SPERMIT command, "NONE" is 
assumed. 


If no parameters are given on the $PERMIT command, the user is prompted 
for filenames and access types, one set per line, until a null line or 
end-of-file is given. For example: 


SPERMIT 
ENTER FILE NAME AND ACCESS METHOD 
MYFILEA ALL 
MYFILEB NONE 
SENDFILE 
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APPENDIX A: 1/0 MODIFIERS 


INTRODUCTION 


Modifiers are used to modify the action of a specific I/0 call or a 
general I/O usage. Modifiers aay be used in I/0 subroutine calls (SCARDS, 
SPRINT, READ, and so on), in macro calls setting up the corresponding I/0 
subroutine calls, in calls to GETFD, or as parts of FDnames given in MTS 
comaands. Modifiers control such functions as upper or lower-case conver- 
sion, logical carriage control, machine carriage control, record trimaing, 
and so on. 


In general, there are three levels of precedence in the usage of 
modifiers. In the first level cf precedence are the nodifiers specified on 
a call to one of the I/O subroutines. If the anodifier is not specified by 
the subroutine call, or if a user generated subroutine call is not relevant 
(e.g., when a $COPY comaand is issued), the second level of precedence, 
which consists of the modifier name as part of the FDname, applies. Note 
that the group of modifiers which can only control the action of a specific 
I/O call (for example ERRRTN and NOTIFY) are not valid at this level of 
precedence. If the action of the sodifier is not specified by the second 
level, the third level of precedence, which consists of the default 
specifications, applies. The default specification depends upon the type of 
FDname referenced in the I/0 call and the settings of global switches. 
These defaults are given in the explanation of modifier bits below. 
Modifier specifications given at the first level of precedence override 
specifications given at the second and third levels. Modifier specifica- 
tions given at the second level override specifications given at the third 
level. This precedence process is illustrated in the diagram below. Each 
modifier pair is treated independently in the above precedence process. 


Level 1: Subroutine Call Modifiers ——--—-————, 


| 
i 
Level 2: FDname Usage Modifiers >I 
| 
{ 
Level 3: Defaults —-——-—-————-——___________--_-_—} | 
{ 
{ 
1 
Effective 
Modifiers 
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The 


example below illustrates the three levels for controlling the TRIM 


nodifier. 


CALL SCARDS (REG,LEN,16384,LNUN) ———y 
(16384 specifies ~TRIM) 1 

I 

SCARDS=FYLE@TRIM on $RUN command ... { 
j 

Default is TRIM for file ceccrecceve f 
{ 

( 

~TRIM 


CALL SCARDS(REG,LEN,O,LNUM) «cocsvcvees 
(0 makes no specification) . 
SCARDS=FYLE@-TRIK ——————————_-—__-_—__—____,, 
! 

Default is TRIM for file weccrcavecel 
| 


( 
~TRIM 


CALL SCARDS (REG, LEN,O,LNUM) sescoosee 
(0 makes no specification) ° 
SCARDS=FYLE eoeeeeoeoeasvpeoeaneev cee evnevneneeeenesn 
Default is TRIM for file —-———-————, 
( 


{ 
TRIM 


The action of the sodifiers specified on a subroutine call is controlled 


by 


a fullword of aodifier bits given as one of the parameters to the 


subroutine. The action of the modifiers on the subroutine call applies only 
to that specific call. There are two classes of anodifiers. 


(1) 


(2) 


Bits 0-7 are referenced individually, and specify the options for a 
specific 1/0 call. If the bit is set, the modifier's action is 
enabled. If the bit is not set, the default specification is used 
(which normally means the modifier action is disabled). 


Bits 68-31 are referenced in pairs and specify options for general I/0 
usage. For each option, one bit is used as an "ON" bit and the other 
as an “"OFF® bit. If either of the bits, but not both, is set, the 
modifier action is as specified. If neither or both of the bits is 
set, indicating a “don't care" condition at this level of precedence, 
the modifier name appended to the FDname is used. If there is no 
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modifier name appended to the FDname, the default specification for the 
FDname type is used. The normal programming practice is to leave the 
modifier bits zero on the subroutine call and apply the modifier names 
to the FDname referenced unless the program depends upon the nodifier 
bits being set for a specific subroutine call. Here is an example done 
first in assembly language and then in FORTRAN: 


CALL SCARDS, (REG, LEN, MOD, LNUM) 


REG DS 20F 

LEN DS H 

MOD DC x*000048000' Specifies no trimming of input lines 
LNUM Ds F 


Note that if the subroutine call is set up by a macro call, the 
modifier names rather than the bits are used in the macro parameter 
list. Thus the above example would become 


SCARDS REG,LEN,@-TRIM,LNUM 
Here is the FOFTRAN version that specifies no trimming: 


INTEGER*2 LEN 
DATA MOD/Z00004000/ 
CALL SCARDS (REG,LEN, MOD, LNUM) 


The action of modifiers applied to the FDnames is controlled by the 
modifier name (preceded by "@") appended to the FDname. The action of the 
modifiers appended to the FDname applies to all I/O calls referring to that 
usage of the file or device. If the modifier name is preceded with "~" or 
t=", the other bit of the bit pair is set, which negates the action of the 
modifier nane. (The modifier applies only to the FDname to which it is 
attached.) If implicit or explicit concatentation to another FDname occurs, 
the aodifiers must be applied to both FDnames even if the FDnames are the 
same. If the user at a terminal is prompted for an FDname, the full FDname 
including the modifiers and line number range must be given with each 
request. The order of modifier names appended to an FDname is unimportant. 
Some examples are 


FILE1 aIauc Specifies indexed and upper case 
PILE2@~TRIM Specifies no trianing 

*SINK*@3NOCC Specifies no logical carriage: control 
*SINK* ACC Specifies no logical carriage control 
RDR1I@BIN Specifies no EBCD conversion 
FILE3@MCC (1,10) Specifies machine carriage control 


PILEZANCC (1,10) + (20,36) aMcc Specifies machine carriage control 
for lines 1 to 10 and 20 to 30 


Tf the modifier action is also specified on a subroutine call, the modifier 
action applied to the FDnane is overridden. 
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OF MODIFIERS 


The device types discussed in the exceptions to the default modifier bit 
specifications are: 


PTR 
TTY 
2741 
2260 
9TP 
SDA 
HPTR 


Printers 

Teletype or ASCII code terminals 

Selectic typewriter based terminals 

IBM 2260 Display Unit 

9=-track magnetic tape drive 

Synchronous data adapter (Remote batch via MEMOREX Controller) 
Printed output under HASP 


The values indicated below with each bit specification are the values that 
the modifier word for a subroutine call would have if only that modifier 
option was specified. 


Bit 31 
30 


SEQUENTIAL, S Value: 1 (dec) 00000001 (hex) 
INDEXED, I 2 00000002 
Default: SEQUENTIAL 


Exceptions: None 


In general, the INDEXED modifier is applied only to line 
files (or sequential-with-line-number=-files), while the 
SEQUENTIAL modifier is applied to line files, sequential 
files, and all types of devices. Note that the SEQUENTIAL 
modifier and the sequential file are not directly related. 
The paragraphs below describe the action of this nodifier 
pair and the results that occur when these modifiers are not 
used in the norgal manner. 


With each logical unit (or FDUB-pointer), there is a current 
line pointer which contains the line number of the last 
record read or written. When an 1/0 operation is performed, 
the current line pointer is first set to the line number of 
the record to be read or written before the actual read or 
write occurs. After the read or write operation has 
occurred, the current line pointer contains the line number 
of the record last read or written. 


I/O operations involving line files (or sequential-with-line- 
number files) may be done with either SEQUENTIAL or INDEXED 
specified. A SEQUENTIAL I/O operation occurs when the user 
specifies that the "next" record is to be read or written. 
For a read operation, “next" means the record that is next in 
ascending line number order from the current value of the 
line pointer (last line read or written) of the same logical 
I/O unit (or FDUBepointer). If, however, an increment was 
explicitly given with the FDname, the line nuaber read is the 
current value of the line pointer plus the first multiple of 
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the specified increment for which there is a line in the 
file. For a write operation, "next" means the current value 
of the line pointer (last line read or written} plus the 
increment specified with the FDname (defaults to 1) of the 
same logical I/0 unit (or FDUB-pointer). An INDEXED I/0 
operation occurs when the user specifies the line number of 
the record to be read or written. As an example, consider 
the following FORTRAN program. segment. 


INTEGER*2 LEN 
DATA MOD/2/ 

1 CALL READ(REG,LEN,O,LNR,2,&2) 
CALL WRITE (REG, LEN,MOD,LNE, 3) 
GO TO 1 

2 STOP 


This program perforas a SEQUENTIAL read and an INDEXED write 
using the line number from the read operation as the line 
number specification for the write operation. The coamand 
(assuming compilation of the above into LOAD) 


$RUN -LOAD 2=A 3=B 
is equivalent to 
SCOPY A Bat 


and copies file A into file B preserving the line nupbers of 
file A as. the line numbers for file B (assuming B is 
initially empty). If a series of I/0 operations involving a 
given usage of a line file are intermixed with INDEXED and 
SEQUENTIAL operations, the SEQUENTIAL operation begins 
sequentially with the line following the last line specified 
in the INDEXED operation. INDEXED operations following 
SEQUENTIAL operations use the line number given in that 
INDEXED specification. - 


I/O operations involving sequential files must be done 
sequentially. If the user specifies INDEXED on a sequential 
file operation, an error message is generated unless the 
global switch SEQFCHK is OFF, in which case the operation. is 
performed as if SEQUENTIAL was specified. Attempting a 
sequential operation with a starting line nuaber other than 1 
(for example, SCOPY FYLE(2) } also gives an error comment if 
SEQFCHK is ON. 


I/O operations involving sequential devices, such as card 
readers, printers, card punches, magnetic tape units, and 
terminals, are inherently sequential and are normally done 
sequentially. If the SEQUENTIAL modifier is specified, the 
line number attached to the line is the current value of the 
line pointer plus the increment specified on the FDname. If 
the INDEXBD modifier is specified, the line number attached 
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Bit 29 
28 


Bit 27 
26 
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to the line is the line number specified in the calling 
sequence. The INDEXED modifier is used primarily in conjunc- 
tion with the PREFIX modifier. Note that the device treats 
the I/O operation as if SEQUENTIAL were specified. 


EBCD Value: 4 (dec) 00000004 (hex) 
BINARY, BIN 8 00000008 
Default: EBCD 


Exceptions: None 


The EBCD/BINARY rmodifier pair is device dependent as to the 
action specified. For card readers and punches, the EBCD 
modifier specifies EBCDIC translation of the card image which 
means that each card column represents one of the 256 8-bit 
EBCDIC character codes. The BINARY modifier specifies that 
the card images are in column binary format which means that 
each card column represents two 8=bit bytes of information. 
The top six and bottom six punch positions of each column 
correspond to the first and second bytes respectively with 
the high order two bits of each byte taken as zero. Printers 
and files ignore the presence of this modifier pair. The 
MEMOREX ‘Transmission Control routines (that is, terminal 
DSR's) recognize this modifier pair. Note that card input 
through HASP (normal batch jobs) cannot be read in colunan 
binary. 


For information on the usage of this modifier pair in 
specifications involving the devices listed above, see the 
respective User's Guides in Volume 4 of the MTS Manual. The 
list of device support routines recognizing this modifier is 
volatile and subject to change without notice. Users who 
wish to keep their programs device-independent should not 
specify this modifier. 


LOWERCASE, LC Value: 16 (dec) 00000010 (hex) 
CASECONV, UC 32 00000020 
Default: LOWERCASE 


Exceptions: None 


The LOWERCASE/CASECONV modifier pair is not device=-dependent. 
If the LOWERCASE modifier is specified, the characters are 
transmitted unchanged. If the CASECONV modifier is speci- 
fied, lower-case letters are changed to upper-case letters. 
This translation is performed in the user's core region. On 
input operations, the characters are read into the user's 
buffer area and then translated. On output operations, the 
characters are translated in the user's buffer area and then 
written out. Only the alphabetic characters (a-z) are 
affected by this modifier. Unlike IBM programming systems, 
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MTS considers the characters ¢, ", and ! as special 
characters rather than "alphabetic extenders" and thus the UC 
modifier does pot convert ¢, ", and ! into @, #, and §&, 


respectively. 
Bit 25 NOCARCNTRL, NOCC Value: 64 (dec) 00000040 (hex) 
24 CC, STACKERSELECT, SS 128 00000080 
Default: NOCARCNTRL 


Exceptions: CC for PTR, TTY, 2741, 2260, SDA, and HPTR 


The NOCC/CC modifier pair is device=-dependent. This modifier 
pair controls the presence or absence of logical carriage 
control (or stacker-selection) on output records. For print- 
er. and terminal devices, the first character of each record 
is taken as logical carriage control if this character is a 
valid carriage control character and if the CC modifier is 
specified. If the first character is not valid as a carriage 
control character, the record is written as if NOCC were 
specified. For further information on logical carriage 
control, see the “Carriage Control" section in Volume 3. For 
card punches, the first character of each card image is taken 
as the stacker-select character if it is a valid logical 
stacker-select character (0, 1, or 2) and if the SS modifier 
is specified. If the first character is not valid asa 
stacker-select character, the card image is punched as if 
wocc were specified. The SS modifier is intended only for 
those users who are communicating directly with a physical 
punch (normally system programmers) and is not implemented 
for normal batch usage under HASP. Note that the SS and CC 
modifiers reference the same modifier bit and thus may be 
used interchangeably. 


The magnetic tape routines also recognize the presence of 
this modifier pair. For this description, see the "Magnetic 
Tape User's Guide" in Volume 4 of the MTS asanual. Files 
ignore the presence of this modifier pair. 


Bit 23 Value: 256 (dec) 00000100 (hex) 
22 PREFIX, PFX 512 00000200 


Default: “PREFIX 
Exceptions: None 


The PREFIX smwodifier pair controls the prefixing of the 
current input or output line with the current line number. 
On terminal input, the current input line number is printed 
before each input line is requested. The line number used is 
determined as specified in the description of the SEQUENTIAL 
and INDEXED modifiers. An example for terminal input is 
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SCOPY *SOURCE* (6,,2) @PFX A(6,,2) 
6. first input line 
8_ second input line 


endeof-file indicator 


Note that this would have the same effect with respect to 
line numbering as 


SGET A 

$NUM 6,2 
6_ first input line 
8_ second input line 


xx_SUNN 


The current (prefix) line number is not equivalent to the 
file line number. In the example above, the prefix line and 
the file line numbers were explicitly made to correspond by 
also specifying a line number range on the output FDname (the 
file A). On input from card readers and files, the PREFIX 
modifier has no effect. On terminal output, the current line 
number is printed before each output line is written. The 
line number used is determined as specified in the descrip- 
tion of the SEQUENTIAL and INDEXED modifiers. An example for 
terminal output is 


SCOPY A(1,10) *SINK*(100,,2) @PFX 
100_ first output line 
102_ second output line 


Note again that the current line number is not equivalent to 
the file line number. On output to the printer or to a file, 
the PREFIX modifier has no effect. 


If the INDEXED and PREFIX modifiers are given together for 
terminal output, the line numbers referenced by the INDEXED 
modifier are the same as those produced by the PREFIX 


modifier. As an example, consider the following FORTRAN 
program segment: 


INTEGER*2 LEN 

DATA MOD/Z00000202/ Turns on INDEXED and PREFIX 
1 CALL READ(REG,LEN,O,LNR,2,62) 

CALL WRITE (REG,LEN,MOD,LNR, 3) 

GO TO 1 
2 STOP 
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This program performs a read SEQUENTIAL and a write INDEXED 
and PREFIX. The command (assuming compilation of the above 
into -LOAD) 

$RUN -LOAD 2=2A 3=*SINK* 
is equivalent to 

SCOPY A . *SINK*@I@PFX 
which is also similar to 

$LIST A 


with a slightly different forrgatting of the line numbers. 


Bit 21 Value: 1026 (dec) 00000800 (hex) 
20 PEEL, GETLINE#, 2048 00000800 
RETURNLINE# 
Default: APEEL 


Exceptions: None 

The PEEL smodifier pair has two functions depending upon 
whether it is specified on input or on output. On input, if 
the PEEL (GETLINE#) modifier is specified, a line number is 
extracted from|the front of the current input line. The line 
nugber is converted to internal form (external value times 
1000) and returned in the line nuaber parameter during the 
read operation, See the subroutine description of SCARDS and 
READ. The remainder of the line is moved into the input 
region specified. As an exasaple, consider the following 
FORTRAN progras segment: 


INTEGER*2 LEN 
DATA MOD/2048/ 
7 CALL SCARDS (REG,LEN,MOD,LNR,&2) Read with PEEL 
CALL SPRINT(REG,LEN,0O,LNR) 
GO TO 1 
2. STO 
The prograas “ote an input line, extracts the line number, 
and writes out the line without its line number. The 
following sequence (assuming compilation of the above into 
-LOAD) 


SRUN ~Loab SCARDS=*SOURCE* SPRINT=ABC 
10AAA 
12BBB 


is equivalent to 
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SCOPY *SOURCE*@GETLINE# ABC 
10AAA 
12BBB 


Listing the file ABC produces 


$LIST ABC 
1 AAA 
2 BBB 


If the PEEL modifier is specified on input in conjunction 
with the INDEXED modifier on output, the line number of the 
input line can be used to control the destination of the line 
during output. For example: 


INTEGER*2 LEN 
DATA MOD1/2048/, MOD2/2/ 
1 CALL SCARDS (REG,LEN,MOD1,LNR,&2) Read with PEEL 


CALL SPRINT (REG,LEN, MOD2,LNR) Write INDEXED 
GO TO 1 
2 STOP 


This program reads an input line, extracts the line number, 
and writes out the line with the extracted line number as the 
line number specification for an indexed write operation. 
The following sequence (assuming compilation of the above 
into -LOAD) 


$RUN -LOAD SCARDS=*SOURCE* SPRINT=ABC 
TOAAA 
12BBB 
is equivalent to 
SCOPY *SOURCE*@GETLINE#. ABC@I 
TOAAA 
12BBB 
which is also equivalent to 
$GET ABC 
1OAAA 
12BBB 


Listing the file ABC produces 


SLIST ABC 
10 AAA 
12 BBB 


On output, if the PEEL (RETURNLINE#) modifier is specified, 
the line nuaber of the current output line is returned in the 
line number parameter of the subroutine call during the write 
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operation. See the subroutine descriptions of SPRINT, 
SPUNCH, SERCOM, and WRITE. The line itself is written out 
and is unaffected by the presence or absence of this 
aodifier. The sodifier is used on output to aid the 
programmer in recording the line number of the current line 
written out. 


‘ Value: 4096 (dec) 00001000 (hex) 
MACHCARCNTRL, acc 8192 00002000 


Default: — mece 
Exceptions: None 


The sachine carriage control srodifier pair is device- 
dependent. The MCC modifier is used for printing output (via 
printers or terminals) from programs producing output in 
which the first byte of each line is to be used as_ the 
command code in the Channel Command Word (CCW) used for 
output to a 1403 printer. If the MCC modifier is specified 
and the first byte of the output line is a valid 1403 CCW 
command code, the line is spaced accordingly and printing 
starts with the next byte as coluan 1. If the first byte is 
not a walid 1903 CCW command code, the entire line is printed 
asing single-spacing. Spacing operations perforned by 
machine carriage control occur after the line is printed (as 
opposed to logical carriage control in which the spacing is 
performed before each line is printed). Most programs do not 
produce output using emachine carriage control. The few 
programs that do (such as *ASHG and the TEXT360 programs) 
internally specify MCC for their output assuming that it is 
bound for a printer. Hence MCC need not be specified. If 
the user directs the output to a file, MCC must be specified 
when the file is printed. For exasgple: 


SRUN *ASMG SCARDS=A SPRINT=B SPUNCH#C 
SCOPY B TO *SINK*@HCC 


The MCC modifier pair is ignored for files and all devices 
other than printers or terminals connected through the 
MEMOREX Transmission Controller. For further inforrgation on 
machine carriage control, see the "Carriage Control" section 
in Volure 3. 


Value: 16384 (dec) 00004000 (hex) 
TRI 32768 00008000 


Default: TRIN 
Exceptions: TRIM for line files, sequential files, and HPTR 


The TRIM modifier pair is used to control the trimsing of 
trailing blanks from input or output lines. If the TRIM 
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modifier is specified, all trailing blanks except one are 
trimmed from the line. If -~TRIM is specified, the line is 
not changed. A trimming operation does not physically delete 
the trailing blanks from the line, but only changes the line 
length count. 


Value: 65536 (dec) 00010000 (hex) 
SPECIAL, SP 131972 00020000 


Default: ~SP 
Exceptions: None 


The SPECIAL modifier pair is reserved for device-dependent 
uses. Its meaning depends upon the particular device type 
with which it is used. The only device support routines 
recognizing this modifier pair are the sequential file 
routines. 


For information on the usage of this modifier pair see 
Appendix B of this volune. The list of device support 
routines recognizing this modifier is volatile and subject to 
change without notice. Users who wish to keep their programs 
device-independent should not specify this modifier. 


Value: 262144 (dec) 000409000 (hex) 
Tc 524288 00080000 


Default: The setting of the IC global switch (usually ON) 
Exceptions: None 


The Ic modifier pair controls implicit concatenation. If the 
Ic modifer is specified, implicit concatenation occurs via 
the "SCONTINUE WITH" line. If -IC is specified, implicit 
concatenation does not occur. For example, $LIST PROGRAM@-IC 
lists the file PROGRAM and prints "SCONTINUE WITH" lines 
instead of interpreting them as implicit concatenation. The 
use of the IC modifier in I/O subroutine calls or as applied 
to FDnames overrides the setting of the isplicit concatena- 
tion global switch (SET IC=ON or SET IC=OFF) for the I/0 
operations for which it is specified. 


ERRRTN Value: 1073741824 (dec) 40000000 (hex) 


Default: ~ERRETN 
Exceptions: None 


If the ERRRTN modifier is specified (bit 1 in the modifier 
word is °1) when an 1/0 call is made, and if an I/O error 
occurs when no SETIOERR/SIOERR interception has been estab- 
lished, the error return code is passed back to the calling 
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program instead of causing an error comment to be printed. 
This modifier may be used only with an I/0 subroutine call. 
It may not be used as an attribute on an FDname. 


NOTIFY Value: -2147483648 (dec) 80000000 (hex) 


Default: aNOTIF Y 
Exceptions: Wone 


If the NOTIFY modifier is specified (bit 0 in the sodifier 
word is 1) when an I/O subroutine call is made, on return GRO 
is set to a value indicating what has happened: 


0 = no unusual occurrence 
1 = new FDUB opened and no I/0 done 
2 and above, reserved for future expansion 


A new FDUB is opened if implicit concatenation occurs if a 
Change to the next meaber of an explicit concatenation is 
effected, or if a replacement FDname is requested. This 
aodifier may be used only with an I/O subroutine call. rt 
may not be used as an attribute on an FDnane. 


752 Files and Devices: Appendix A 


MTS Volume 1: MTS -* The Systen 


April 1974 


APPENDIX _B:_ SEQUENTIAL FILES AND NOTE AND _POLNT 


Associated with every sequential file are at least three logical pointers 
which determine where the next read or write operation starts. Every 
sequential file has one Read Pointer, one Write Pointer, and one Last 
Pointer for each usage of the file.! These logical pointers are automatical- 
ly updated after every read or write operation by the file routines as 
outlined below. In addition, two subroutines, NOTE and POINT, callable from 
assembly language and FORTRAN, "“remember" the current values of these 
logical pointers, and, at some later time, "alter" the values of these 
pointers. In so doing, a user is able to start reading and/or writing a 
sequential file from points other than the beginning and/or end of the file. 


These three logical pointers are manipulated by the file routines as 
follows: 


The Read Pointer is always initially set to point to the beginning of the 
file when the file is created or first referenced. The Read Pointer is 
updated after every read operation to point to the next line to be read. A 
particular Read Pointer affected by a rewind operation (that is, the Read 
Pointer associated with the FDUB on which the rewind was given) is reset to 
point to the beginning of the file. Finally, all Read Pointers are reset to 
point to the beginning of the file whenever the file is emptied. 


The Write Pointer is initially set to point to the beginning of the file 
when the file is created, and is updated after every write operation to 
point to the next line to be written. The Write Pointer is reset to point 
to the beginning of the file when the file is emptied or rewound. In 
addition, if after any read operation, the Read Pointer is greater than the 
Write Pointer, the Write Pointer is updated to coincide with the Read 
Pointer. This allows a user to rewind a sequential file, begin reading, 
stop at some intermediate point and begin writing at that point. This is 
similar to what would happen if the same operations were performed on a 
magnetic tape. The difference is that, if after writing a few lines, the 
user again began to read the file, he would begin reading froa the 
intermediate point at which he previously stopped reading and started 
writing (that is, the Read Pointer is not updated after a write operation). 
Finally, whenever the file is opened, the Write Pointer is set equal to the 
Last Pointer. 


The Last Pointer is initially set to point to the beginning of the file 
when the file is created, and is updated after every write operation to 


twhen a user has more than one logical I/O unit attached to the same file, 
or has called the subroutine GETFD more than once for the same file, MTS 
creates a FDUB (File or Device Usage Block) for each of these usages, and 
each FDUB points to the one File Control Block (FCB) for the file. (This is 
not the case when two separate users each have a single usage attached to 
the same (shared) file. In this case each user has a FDUB pointing to his 
own FCB for the given file.) The ramifications of more than one Read 
Pointer are discussed later. 
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coincide with the new updated Write Pointer. The Last Pointer is also 
considered the logical end of file, so that writing a file beginning fron 
some intermediate point implies that any information from that point on is 
to be discarded. However, if the write operation had the @S5P nodifier 
specified, the Last Pointer is not set to the Write Pointer after the 
operation, and the rest of the information is still there. In this case, 
the record being written into the file must have the same length as the one 
that was there before. If it is not the same length, it is truncated or 
padded with blanks as necessary, it is written into the file, and then an 
error message {({interceptable as usual with the @ERRRTN modifier or the 
SETIOERR subroutine) is issued. Finally, the Last Pointer is reset to point 
to the beginning of the file whenever the file is emptied. 


The NOTE subroutine can be called to obtain the values of these pointers 
when reading and/or writing a sequential file, and then the POINT subroutine 
can be called to "reposition" these pointers. (See the subroutine descrip=- 
tions in Voluse 3 for calling sequences.) A call to NOTE obtains four 
fullwords of information to be used later. These four fuliwords are 
respectively, the Read, Write, and Last Pointers, as well as the last line 
number (useful only for sequential-with-line-nuaber files)? associated with 
the file corresponding to the FDUB-pointer given. These pointers always 
correspond to the next jine about to be read or written. At some later 
point in time, the caller is able to indicate which of these pointers he 
wishes to alter for the next read or write operation and, using the 
inforraation returned by NOTE, can call the POINT subroutine appropriately. 


The logical pointers are valid from one copy of a sequential file to 
another as long as both copies are located on the same kind of storage. 
Thus, the pointers returned by NOTE for a file on the disk can be used to 
point into an identical copy of the file elsewhere on disk storage. 


fhe user should be aware of the consequences of reading and/or writing 
multiple logical I/0 units or other usages attached to the same file. Since 
there is one Read Pointer associated with each FPDUB-pointer and with each 
logical I/O unit, the user is able to read alternately from a number of 
different points in the file, overlapping or not as the application 
dictates. However, since there is only one Write Pointer and one Last 
Pointer associated with the file, writing to multiple usages attached to the 
same file amounts to siaply appending to the end of the file in the order 
that the write requests are received. 


2The rationale for wanting to remernber the last line number in a sequential 
file with line nuabers is that when writing this type of file, the caller 
mast insure that line nuabers are in numerically increasing order. 
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APPENDIX Ci: INTERNAL FILE STRUCTURE AND THE SIZE _OF FILES 


In order to attempt some explanation of how big a file must be to hold a 
specified amount of data, a certain amount of detail about the internal 
structure of a file is needed. 


The basic unit of a file is a physical record. Files (both line and 
sequential) on the 2314 disks are written two records per physical track; 
each record is 3520 bytes long. Since disk space is allocated to files in 
tracks, each disk file contains an even number of records. 


At this point, the explanation must be split into two categories -- line 
files and sequential files, since the allocations of records in these two 
types of organization differs considerably. 


Line Files 


A line file contains three logical components: the track index, the line 
directory, and the data section. 


The track index is used to associate a physical disk address (disk pack 
volume name, cylinder, track, and record address) with a logical record 
number (integer between 1 and 218). In the line directory, all references 
are to a logical record number. This saves space and makes the addressing 
relative. 


The line directory is fixed-length entries, one for each line in the 
file, and ordered by line number. There are also entries for each available 
“hole” in the data section. These entries contain the line number, the 
length of the line, and indicate where that line is, in terms of logical 
record number and offset within the record. The line directory only points 
to the lines themselves, which are in the data section. 


The data section contains the actual lines, unordered and unpacked (that 
is, holes that result because of line replacements stay there until a piece 
that length or less is needed). 

If the file is small enough, the track index and line directory may _ he 
contained in one physical record. When the file gets larger than this 
limit, then it is called "extended", and the track index occupies one record 
and the line directory occupies one or more records. 

Now to get some approximate numbers for sizes of line files. 


If n is the number of lines in the file, 
r is the average length of a line, 


then the number of records needed: 
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R = data section + line directory + track index 


which is approxirzately 


4 


where x = 0 if the file is not extended 
(line directory is with track index) 


and x = [n/439] if extended (439 8-byte entries in a 3520 
_ byte record less 8=-byte header) and if not 
an integer, the next larger integer. 
The criterion for extension is 
track index bytes + line directory bytes > 3520 = 8-byte header 
or 46*R + 8%n > 3512 
or n > 439=2*R 
so that if n > 435, the file is definitely extended. 
(R/2) 
T*7290 70096 


The nusgber of tracks needed is T 


The number of pages charged is P 


fhe above figures are approximate, and closest only: when the file is 
first filled. In particular, the parameter n above really is the nusgber of 
lines plus the number of holes, and, after the file has undergone auch 
editing, it may be considerably greater than the number of lines. Copying a 
file into another file, exzptying the original file, and then copying it back 
contenses the file. This procedure is recommended after a file has been 
extensively edited. 


Sequential Files 


The organization of sequential files (with or without line numbers) is 
quite siaple compared to line files. In general, the first n bytes 
(currently n=215) of the first record are used as a header in w#hich 
pertinent information about the sequential file is retained. 


Ianediately following this header information are the lines of informa- 
tion stored in the sequence in which they were received. Since these lines 
may be up to 32767 bytes long, and since the physical records on the disk 
are 3520 bytes, it is quite possible that a line has to be ‘broken ap and 
stored on gore than one physical record. Since the lines are packed end to 
end esing up all of one physical record before going on to the next physical 
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record, this is quite likely, even if only "short" lines are written into a 
sequential file. Thus it turns out that even short lines may be broken 
across physical record boundaries. 


For this reason it is convenient to refer to a segment of a line as. that 
part of the line which resides on a physical record. A line can therefore 
consist of one segment, two segments, or nore, depending on the size of the 
line, the size of the physical records, and how the line “fell" with respect 
to physical record boundaries. Each segment of a line in a sequential file 
has either 10 or 6 bytes of overhead associated with it depending on whether 
it is in a sequential file with or without line numbers. 


This gives the following lower bound for the number of records: 


r 1 
4215 + n* (r+k) | 
R= | ( 
! 3520 1 
t J 
where k=6 if SEQ 
=10 if SEQUWL 
The number of tracks needed: T = (8/2) 
The number of pages charged: P = 1*7296/4096 


This is a lower bound because it does not consider that when a line is 
spanned across record boundaries, each of the segments has the k bytes of 
overhead information attached to it, and on the average, probably every 
record boundary has a line spanned across it. 


All of the numbers in this appendix are subject to change without notice. 
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APPENDIX D:__I/0 ROUTINES RETURN CODES 


The return codes that may result from a call on an input or output 
subroutine depend on the type of the file or the device used in the 
operation. In general, a return code of zero means successful coapletion of 
the input or output operation, and a return code of 4 means end-of-file for 
an input operation and end-of-file-or-device for an output operation. Tf 
the file or device being used was specified as part of an explicit 
concatenation (and is rot the last member of that concatenation), a return 
code of 4 causes progression to the next element of the concatenation, and 
that return code is not passed back to the caller. For. exaraple, if 


SCARDS=A+B 


then when the call is made to the SCARDS subroutine after the last line in A 
has been read, the file routines signal an end-ofefile, but this is 
intercepted, and the first line in B is read. 


Return codes greater than 4 are normally not passed back to the caller 
but instead cause an error comment to be printed and control to be returned 
to command sode. There are two ways to suppress this action and gain 
control in this situation. First, the subroutines SETIOERR and SIOERR (see 
descriptions in Volume 3) are provided to permit a global intercept of all 
input/output errors. Secondly, specifying the ERRRTN modifier on an Tf/0 
subroutine call causes all return codes to be passed back. 


A description of the return codes that may occur with a particular file 
or device is found in the appropriate User's Guide. In addition, a summary 
is provided below. Non-zero return codes marked with an asterisk are fatal 
error returns; the others are considered errors by MTS, but are not 
necessarily fatal. 


Files: 


Input 0 Successful return 
4 End-of-file (sequential read) 
Line not in file (indexed read) 
8* Error 
Output 0 Successful return : 
ad Size of file exceeded a 
8% Line numbers not in sequence (SEQWL) 


12* For future expansion, should not occur 

16* For future expansion, should not occur 

20* Sequential file written with indexed aodifier, or 
written with starting line number other than 1 

2h Systea error 

28* Hardware or system error 

32 Line truncated (3SP on sequential file ) 

36 Line padded (@SP on sequential file) 
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Magnetic tape: 
Input 


28* 
32* 


36* 


Output 0 
4 


28* 
32* 


36* 


Card input under HASP: 
Input 0 
4 

8* 
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Successful return 

Tape-mark (end-of-file) sensed on read, BSR, or FSR 
operation 

Load point reached on BSR or BSF control command 
Logical end of labeled tape reached on read, FSR, 
or PSF operation 

Non-recoverable hardware I/O error or invalid con- 
trol command parameter 

Should not occur 

Fatal error (may be due to hardware salfunction, 
label error in which the position of the tape is 
uncertain, or pulling the tape off the end of the 
reel during a read, FSR, or FSF operation); follow- 
ing a fatal error, the tape must be rewound before 
any other I/0 operation is allowed 

Volume or data set in error 

Sequence error caused by issuing a control command 
when the tape is not positioned properly; or a 
read, FSR, or FSF operation following a write 
operation 

Deblocking error caused by improper blocking para- 
meters, for example, atteapting to deblock a format 
FB file using a format VB specification 


Successful return 

End-ofetape marker sensed during write or WTM 
operation 

Load point reached on BSR or BSF control conmand 
Attempt to write more than 5 additional records 
after end-of-tape marker sensed 

Non-recoverable hardware I/O error, invalid control 
command, or invalid control command parameter 
Attempt to write on file-protected tape 

Fatal error (may be due to hardware malfunction, 
label error in which the position of the tape is 
uncertain, or pulling the tape off the end of the 
reel during a read, FSR, or FSF operation); follow= 
ing a fatal error, the tape aust be rewound before 
any other I/0 operation is allowed 

Volume or data set in error 

Sequence error caused by issuing a control command 
when the tape is not positioned properly; or a 
read, FSR, or FSF operation following a write 
operation 

blocking error caused by improper blocking parame- 
ters which are inconsistent with the labels of the 
file being written 


Successful return 
End-of-file 
Attempt to read in column binary aode 
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Output 


Printed Output: 
Input 


Output 


Punched Output: 
Input 


Output 


MERIT Network: 
Inputs 


Output 


Control 


Most other devices: 
Input 


8* 


8* 


0 
4 
ge 
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Attempt to write on card reader 


Atterpt to read from printer 


Successful return 
Local page limit exceeded (User never gets control 
back for global liasit exceeded.) 


Attempt to read from punch 


Successful return 
Local card limit exceeded (User never gets control 
back for global limit exceeded.) 


Successful return 

End-of-file read from network. This does not 
necessarily mean that there is no sore data to he 
read from the network, only that the remote host 
has sent an end-of-file. 

Read not allowed; must write. This means that the 
rerote host is requesting input from the network 
and, to avoid a deadlock, the local program sust 
not read from the network. The prompting charac- 
ters sent by the remote host yhen it did the read 
are returned to the user. 

Should not occur 

Connection is closed; no I/0 may be done. 


Successful return 

Should not occur 

Write not allowed; aust read. This means that the 
remote host has issued a write on the network and, 
to avoid a deadlock, the local program must not 
write on the network. 

Should not occur 

Connection is closed; no I/O may be done. 


Saccessful return 


_£rror in control command for local host 


Control coamand not allowed -- the rerote host has 
not done a read. 

Should not occur 

Incorrect control coamand syntax for remote host 
Invalid syntax or context for control command 


Successful return 
End-of-file 
Error 
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Outpat 0 Successful return 
4 End-of-file-or-device {if applicable] 
8* Error 
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APPENDIX BE: UPDATING FILES DEFENSIVELY IN BTS 


One of the hazards of using a time-sharing -systea like MTS is the 
unfortunate fact that when machine problemas or power failures cause the 
system to go down abruptly, terminal users are left holding the phone with 
no recourse for recovery of work currently in progress. This is particular- 
ly frustrating if the terminal user happens to be in the process of updating 
a file when the system goes down. Due to the structure of files in MTS, it 
is quite possible that a random portion of the most recent changes he 
initiates may not be made. In addition, if the terminal user is particular- 
ly unfortunate, his partially updated file may possibly be left in an 
inconsistent, unusable state by the abrupt halting of his terminal session. 


Two questions often asked are: Why are some changes made before a systen 
crash and not in the users file after the system comes up? What can the 
terminal user (or even an interactive prograrz) do to minimize the man-hours 
lost when the updating process is terminated prematurely due to machine or 
power failures? 


. To understand the answer to the first question (why changes are not 
really made), some background about the file systen in MTS is necessary. 


When a file is first referenced, the first few physical blocks (physical 
units of information, in general containing many lines) of the file are read 
from disk and placed into buffers (blocks of storage in main memory). This 
is done because transferring information to and from the user via these 
buffer images of the physical blocks is much nore efficient than actually 
reading and writing physical blocks of secondary storage at every request. 
This process of reading the first few physical blocks into buffers when the 
file is first referenced has historically been called “opening the file." 
When MTS is requested to read a line (logical record) from the file and pass 
it to the user, if that line happens to be in a buffer, the information is 
immediately passed to the requester. If the line is not in the buffer, an 
existing buffer sust be “emptied" and the physical block on secondary 
storage containing the requested line must then be read from disk into the 
now empty main memory buffer and then, as before, the line requested is 
passed to the user. 


Similarly, when NTS is requested to take a line from the user and write 
it into a file, if that line “happens to fit" (both physically and 
logically) into a buffer in main semory, it is put directly into the 
appropriate place in the buffer. If it doesn't happen to fit into any 
buffers, an existing buffer sust be "emptied" and the physical block fron 
secondary storage into which the line properly goes is read into the empty 
buffer and the line "fitted" into the appropriate place. In either case, 
once the line is “written", the buffer into which it was placed is flagged 
as changed. This means that the buffer in main memory is no longer 
identical to the corresponding physical block on secondary storage and, sore 
importantly, the buffer image in main storage is henceforth the one and only 
valid representation of that bicck of the file. 
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The problem is that while a file is open, its true and valid state is 
reflected not only in its physical blocks on secondary storage but also by 
its “quite possibly changed" buffer images in main memory. When the syster 
goes down abruptly, all buffer images in main memory are lost. 


Thus the big question appears to be: When are buffer images in sain 
memory written out in updated form on secondary storage? The answer is that 
while the file is open the buffers are written out to secondary storage only 
when necessary. Whenever a new physical block is needed in main memory and 
a buffer is not available, an existing buffer must be emptied. Before that 
buffer is emptied and reused, however, a check is made to see if the buffer 
has been changed, and, if it has, the buffer is written back on secondary 
storage in updated form. There is no direct relationship between the tine 
changes are made to a buffer and the time the buffer is written in updated 
form on secondary storage. 


When the user has finally finished updating the file, MTS writes all main 
memory buffers that have been changed in updated form onto secondary 
storage. Only at this point is the file safely on secondary storage in a 
consistent and up-to-date state. This process of writing changed buffers 
onto secondary storage historically has been called "closing the file". 


Turning to the second question, it becomes evident that the one thing a 
terminal user (or interactive program) can do to minimize loses when the 
system goes down during the updating process is to request MTS to close a 
file more often than it otherwise might. This brings up the question, when 
does MTS normally close a file? To minimize loses, MIS closes all open 
files before the execution of every command. To answer the second question, 
if a terminal user is adding information to a file over long periods of tine 
using automatic numbering, it would be expedient to occasionally do a 
SCOMMENT command. This would at least guarantee that lines entered up _ to 
the point of the S$COMMENT command were properly written on secondary 
storage. 


If a file is being updated from a terminal using the context editor 
(SEDIT), the editor command "MTS $EDIT" returns to MTS command mode and then 
returns to the editor. This ensures that the file being edited is properly 
written to the point of the S$EDIT command. (Note that the congands 
“CHECKPOINT” and "RESTORE" are of no help in the event of system crashes, 
since they are meant to be used only if the user changes his mind and wishes 
to backtrack.) 


The MTS subroutine FREEFD (the counterpart of GETFD) also closes the 
indicated file. Thus, interactive user programs which write large amounts 
of information into a file over long periods of time should occasionally 
call FREEFD (and GETFD again) to ensure that changes made up to that point 
in time are actually accomplished. In particular, programs which complete 
the updating process but continue to execute for long periods of time should 
always call FREEFD as soon as updating is complete, since MTS does not close 
the file until execution has terminated. 


These procedures allow a user or program to force MTS to close a file 
more often than it otherwise might, and in that way do auch to sinimize the 
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man-hours of work lost if the system goes down before the updating process 
is completed. There is not much that can be done to salvage the changes 
that were sade between the time the file was last closed and the tise the 
system went down. Generally the only lose is that of checking and redoing 
those changes (not necessarily the rost recent) entered but not accosplished 
during the last open period. If one is unlucky, his file (open when the 
systea crashed) will show signs of inconsistency which are not correctable 
through normal seans. These inconsistencies are evidenced by, for exaaple, 
two lines with the sarze line number, or lines which refuse to be deleted or 
altered, Sore inconsistencies, hovever, make a file totally unreadable. In 
cases of this nature, Academic Services should be consulted, and if the 
damage is beyond human repair, the file will have to be restored from a 
save-tape to its status of the day before. In cases where many and 
time-consuming updates are being nade over long periods of the day and the 
restoring of a file to its status of the day before cannot be tolerated, the 
user should probably sake changes to a copy of the file and periodically 
update the original by $cOPYing the copy. 


Some general coasents can be made in closing. First, upon reflection, it 
should be evident that if a file is only being read, no problems can result 
from a system crash since none of the main serory buffers are changed and 
thus the file on secondary storage is always valid. Second, due to their 
internal structure, line files are much gore susceptible than sequential 
files to inconsistencies caused by system crashes during an updating 
process. Thas one should ase sequential files if at all possible. Finally, 
update defensively. The work you save is your own. 
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SYSTEM COMMAND LANGUAGE 


The sequence of operations of a job run in MTS is controlled by the 
commands of the system command language. A command is a request for the 
system to perform a function such as running a program, creating or 
destroying a file, or setting a global switch. 


The system command language provides several modes of operation. The 
basic mode is MTS command mode. Several other modes also exist which are 
logically separate modes within the system command language. This means 
that each mode may be entered or left at any time without affecting the 
status of any other mode. The other modes currently available are: 


(1) execution mode which is running a user prograa, 

(2) edit mode which is supported by the context editor, 

(3) debug mode which is supported by the symbolic debugging system, and 
(4) network mode which interfaces the MERIT computer network. 


The interpretation of a line entered by the user at a terminal or of a 
card read from a batch job depends on which mode is in control and reading 
the input line. If the MTS monitor is in control, the system is in MsTS 
command aode. This is the norgal mode of operation for the systen. In MTS 
command mode, the system is waiting for the next MTS command to process or 
the next line to enter into the currently-active file. If the context 
editor is in control, the system is in edit mode; if the symbolic debugging 
system is in control, the system is in debug mode. If the user is running a 
program, then his program is in control and he is in execution mode. The 
interaction of these modes is discussed below. 


PREFIX CHARACTERS 


In order that the user can determine the mode of the system, a prefix 
¢ is printed at the front of all input or output lines at the 
terminal to indicate "who is speaking" or “who is listening". On output 
lines, this prefix character is typed ahead of the message. When input is 
requested, either the prefix character (if automatic line numbering is off) 
or the prefix character followed by the line number (in MTS command mode if 
automatic line numbering due to the NUMBER command is on) is typed at the 
front of the line. Each mode of the system has a distinct prefix character. 
For example, MTS command mode uses the pound sign "#",. Thus, whenever the 
MTS monitor is expecting a command line or data line to place in the 
currently-active file, it types a "#" in the first character position of the 
terminal line and waits for input. The system prefix characters are: 
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ERR panmnmeeenenemn | 


{ { Prefix | 
{ Mode { Character | 
if 
! | ! 
1 MTS command sode ( # { 
| Copying ( > { 
{ Loading | ° | 
{ Proapting | ? 1 
{ { | 
{ Edit command sode { : { 
1 Fast insertion t { 
{ | i 
{ Debug comsand node ! + | 
| At-insertion i % 1 
| { { 
| Network comagzand sode | ) ! 
{ ! { 
] Execution sode { blank { 
{ | | 


In addition, sany of the programs available in public files use prefix 
characters. For example, PIL uses "=". The execution mode prefix character 
can be changed by the subroutine SETPFX which is described in Volume 3. The 
printing of prefix characters can be suppressed by the command 


S$SET PFX=OFF 


LHTERACTION OF BODES 


The following is a descripticn of the interaction of the various sodes. 
The normal sode is MTS command sode (sometimes called just "command node"). 
The user always starts in this mode, and reverts to it in case of trouble. 


NTS_Command and Execution Node 


The user may enter execution sode via the RUN, START, or RESTART 
cosrands. When the user is in execution mode, the executing program is in 
control. The return to STS command sode is normally accoaplished by: 


(1) the program returning to MTS (or calling the subroutines SYSTEM, 
MTS, MTSCHD, or ERROR); 

(2) the programa exceeding a local time, page, or card lisit; 

(3) in batch use, the program exceeding the global time, page, or card 
linit; 

(4) din conversational use, the user issuing an attention interrupt, 

the program being executed has called the appropriate 

subroutines to intercept attention interrupts; or 
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(5) some abnormal condition (such as a program interrupt) occurring and 
the program has not called the appropriate subroutines to intercept 
the condition. 


MTS_ Command and Debug Command Mode 


The user may enter debug command mode via the DEBUG or SDS commands. 
When the user is in debug mode, the symbolic debugging systea is in control. 
If a "one-shot" debug command is specified with the SDS command, that debug 
command is executed in debug mode and then an immediate return is saade to 
MTS command mode. The user may return to MTS command aode via the MTS or 
STOP debug commands. If STOP is used, the storage used by the symbolic 
debugging system is released. 


Debug Command and Execution Mode 


The user may enter executicn mode from SDS via the RUN, CONTINUE, GOTO, 
or STEP debug commands. A return is made from execution mode to debug 
command mode in the same manner as from execution mode to MTS command aode 
(see above). Also, a return is made to debug mode when any of the following 
conditions occur: 


(1) encountering a breakpoint or atepoint in the progran; 

(2) completion of the step count for the STEP command; 

(3) calling the subroutines LINK, LOAD, or XCTL when the XFR debug 
option is ON. 


If the SET DEBUG=ON option has been specified, the user may enter execution 
node indirectly through debug aode from MTS command mode via the RUN, START, 
or RESTART conmands. The retutn from execution saode is made through debug 
node to MTS command node. . 


MTS_ Command and Edit Command Mode 


The user may enter edit command node via the EDIT command. When the user 
is in edit command mode, the context editor is in control. If a "one-shot" 
edit command is specified with the EDIT command, that edit command is 
executed in edit mode and then an immediate return is made to MTS command 
mode. The user may return to MTS command aode via the MTS or STOP edit 
commands. If STOP is used, the file being edited is released by the editor. 


NTS_Command_and Network Command Mode 


The user may enter into network command aode via the NET command. When 
the user is in network command mode, the user is interfaced with the MERIT 
computer network. The user may return to MTS command mode via the MTS or 
STOP network commands. If STOP is used, the storage used by the network 
interface is released. 
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Copying 


Copying is an extension of MTS command mode. Copying is in effect when a 
COPY or LIST command has been given in MTS command mode. When copying, the. 
user is reading lines from one file or device and writing them on another 
file or device. When an end~of-file condition is received from the file or 
device being read frou, copying stops. In conversational use, copying also 
stops if the user issues an attention interrupt. 


In order to copy a SENDFILE line from *SOURCE* or *MSOURCE*, a S$SET 
ENDFILE=NEVER command nust be issued first. In this case, the terminal user 
must use an end-of-file. terminal control character to terminate the copying. 
The batch user must normally sake this COPY or LIST command the last command 
in the card deck, since in this situation, the copying proceeds until the 
end of his deck or antil the line SCONTINUE WITH *DUMNNY* is encountered. 


Loading 


Loading is an extension of MTS command mode. When 4 RUN, LOAD, or DEBUG 
cornsgand is given, the dynamic loader takes control to load the specified 
progran. This is a temporary condition. After the progras is loaded, the 
user is then in execution acde (for a RUN command), MTS command mode (for a 
LOAD command), or debug sode (for a DEBUG command). All error messages from 
the loader and the load map, if requested, are printed by the dynamic 
loader. 


Proapting 


This is an extension of MTS command mode for conversational use. When 
the prefix character "“?" appears at the front of an input line, the user 
must enter the information that was requested on the previous output line. 
This usually occurs because of an erroneous or incomplete command or when 
confiragation is requested for a DESTROY or EMPTY command. 


CONMANDS ABD DELINITERS 
Commands are interpreted as such by MTS only if MTS is in MTS command 
mode. Thus a line 
SCOPY AB 


is treated as a copy cormmand if the MTS monitor reads the line, but is 
treated as a data line if the user's program reads it during execution aode. 


Delisiters are constructs which are recognized in a broader context than 
commands. Because these delimiters start with a dollar sign "$", they are 
often erroneously considered to be commands. Since they are not commands, 
the dollar sign is not optional, and there are no abbreviations for thea. 
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There are currently two delimiters: the end-of-file delimiter and the 
implicit concatenation delimiter. 


The form of the endfile delimiter is 
SENDFILE 


Sensing this delimiter causes an end-of-file condition to be signalled. The 
scope of this delimiter depends on the setting of the global ENDFILE switch 
which can be set by the MTS SET command or by the CUINFO subroutine. (See 
the GUINFO, CUINFO subroutine description in Volume 3.) In the default 
case, ENDFILE=OFF, a line consisting of "S$ENDFILE" is recognized as a 
delimiter only if it is read from *SOURCE* or *MSOURCE*. If the SET command 
specifies ENDFILE=ON, a line consisting of "SENDFILE" is always treated as 
an end*of-file delimiter. If ENDFILE=NEVER is specified, a line consisting 
of "“$ENDFILE" is never treated as a delimiter, but is always treated as a 
data line. 


The form of the implicit concatenation delimiter is 
SCONTINUESWITH FDname [RETURN ] 


where « means exactly one blank. A line with this construct, if recognized 
as a delimiter, causes implicit concatenation to occur. For a description 
of implicit concatenation, see the "Files and Devices" description in this 
volume. Recognition of a delimiter is controlled by both a global switch 
and a pair of I/0 modifier bits. The global switch is Ic and its setting is 
specified by the SET command. Its values are either ON or OFF. The default 
case is IC=ON which means that this construct is recognized as a delimiter. 
The 1/0 modifiers are Ic and ~ICc (see "Files and Devices") and when applied 
to an FDnamne, they override the setting of the global Ic switch for those 
usages of the FDname. 
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MTS COMMAND MODE 


MTS command mode is the default mode for the system. In MTS command 
mode, the MTS monitor is looking for the next command to process or the next 
data line to enter into the currently active file. It is in MTS command 
mode that the user initially begins his job and issues the various commands 
for running his prograsas. It is to MTS command mode that the user returns 
after his programs have terminated execution (either normally or 
abnormally). 


In MTS command mode, input lines are read from *SOURCE*. *SOURCE* refers 
initially to the user's terminal or to the card reader for batch jobs 
submitted. This initial assignment may be changed by using the SSOURCE 
command. 


COMMAND LINES AND DATA LINES 


All lines read in MTS command mode are either 


(1) interpreted as commands, or 
(2) written into the currently active file. 


The currently active file is established with either a $GET command (if 
it already exists) or a SCREATE command (if it does not exist). Another 
$GET or $CREATE establishes a different active file; the S$RELEASE or 
$DESTROY command removes it. 


A single dollar sign "$", cccurring as the first character in the input 
line from *SOURCE*, is used to indicate that the line is a command line. If 
an input line does not begin with a single "S$", it may be interpreted by MTS 
as a data line. Data lines are put into the currently active file. Every 
data line must have a line number associated with it. This is accosplished 
in MTS in two ways: either MTS supplies the line number (automatic line 


numbering on), or the user supplies the line number himself (automatic line 
numbering off). 


In the first method (automatic line numbering on), MTS automatically 
assigns a line number to each input line. Automatic nuabering is enabled by 
the S$NUMBER command. Any line which is entered is interpreted as a data 
line unless the first character is a single "$" in which case MTS interprets 
the line as a command. For example: 


SCOMMENT 
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is interpreted as a $COMMENT command and the line is not placed into the 
active file. On the other hand the line: 


COMMENT 


is treated as a data line. It is given the line nuaber which appeared as 
the terminal prefix number and placed in the active file. To actually place 
the line "S$COMMENT® into the active file, the line: 


SSCOMMENT 


must be specified. The first dollar sign is resaoved from the line before it 
is given a line number and placed into the active file, 


In the second method (automatic line numbering off), the user must supply 
a line number with each line entered. This line number is specified by 
placing a legal MTS line number starting at the first character position on 
the line. A legal MTS line number is a decimal or integer nuaber between 
-99999.999 and +99999.999 inclusive. MTS scans the line for a line nuaber 
and if present, strips it from the line, and places the characters following 
the line number into the active file at the indicated line position. For 
example: 


15HI THERE 
places the characters "HI THERE" into the active file as line 15. The line 
nuaber separator character "," may optionally be used to separate the the 
line number from the rest of the line when the line nuaber and the line 
might be confused. For example: 

21.6,10392 CONTINUE 

would place the line "10312 CONTINUE" at line position 21.6 of the active 
file. If the user wishes to enter a line into the active file beginning 
with a ",", he aust either specify two commas or change the line nuasber 
separator character with the SBT command. For exaaple, either 

25,,ABCDE 
or 


SSET LNS=| 
251, ABCDE 


enters the line ",ABCDE" into line position 25 of the active file. 

Users are cautioned that a line is still treated as a command if the 
first character after the line number (ignoring a line nuaber separator) is 
a single "$" and the second character is something else. For example: 


10, SCOMMENT 
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is treated as a COMMENT command and: 
10, SSCOMMENT 


must be specified if the line "SCOMMENT" is to be placed at line 10 of the 
active file. 


The following table summarizes the effects of entering a line with zero, 
one or two dollar signs. 


a ee 
{ { No § { One $ { Two $ | 
{ Line numbering on ( Data { Command { Data { 
{ (terminal or batch) i line { line ( line | 
] Line numbering off } Command {| Command { Data ] 
{ with no active file { line { line { line { 
{ (terminal) | { | ( 
-—_—_—____—___ 1 HHI 
| Line numbering off { Command {| Command { Data | 
{ with an active file { line | line { line i 
( (terminal) ( ] ] { 
dn Sa Sa ane 
( Line numbering off 1 Data { Command | Data { 
| (batch) { line ( line { line { 


ee ee ee nn | 


A line that starts with a single "$" is always treated as a command. A line 
that starts with two dollar signs "$8" is always treated as a data line. If 
no "$t is present the line is treated as a command for a terminal user if 
and only if 


(1) there is no line number at the beginning of the line and automatic 
line numbering is off, or 
(2) there is no active file. 


In these cases the dollar sign is still optional but is completely ignored. 
If there is an active file and automatic numbering is on, then a dollar sign 
is required to distinguish command lines from data lines for the active 
file; if a line number is typed at the front of the line, a dollar sign is 
required for the same reason. The dollar sign is required in batch mode to 
avoid interpreting data as commands and causing irreversible damage to 
files. 


If there is no currently active file and the line cannot be interpreted 
as a command, it is ignored and the comment “INVALID COMMAND" is given. 
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CONTINUATION LINES 


If the last character of an input line from *SOURCE* being read by the 
ETS gonitor is a ainus sign "-", then the next input line is assumed to be a 
continuation of the current line. Continuation begins with the first 
character of the next line, which may be assumed to replace the "~~" 
continuation character in the previous line. As many continuation lines as 
desired may be used vith the restriction that their total length say not 
exceed 255 characters. In batch, the last character position is coluan 80 
on the card. For a terminal input line, the "=" must be the last character 
typed before the termination of the line. 


GLOBAL AED LOCAL LISIZS 


In order to prevent runeaway jobs in batch sode, it is necessary to 
provide some means for the user to limit the CPU time a job may use and the 
amount of output (paper and cards) it produces. It isa often desirable for 
users at a terminal to be able to limit the execution time and output of a 
single prograa. To provide this facility, global and local limits are 
provided. 


Global limits apply for the entire job from sign-on to sign-off. They 
are valid for batch jobs only and may be specified on the SIGNON command. 
Default values are assumed for any omitted limit specifications. There are 
no global limits imposed for tersginal jobs. 


Local. lismits apply for the execution of a single program. They may be 
specified on the SRUN, SLOAD, SRESTART, or SSTART commands. If a SRESTART 
or S$START command specifies no limits, then what is remaining of the limits 
specified by the original S$RUN or SLOAD command is used. If no lisits are 
imposed for the execution or output of a program, then the program is not 
limited in terminal node and lisited only by the global limits in batch 
node. 


The first limit to be exceeded, whether global or local, causes an error 
comment to be printed and the job terminated (if a global limit), or a 
return to command mode (if a local limit). 


A program storage durep is given if a limit has been exceeded in batch 
mode while executing a program and if the duap has been requested by the 
SERRORDUMP command, the ERRORDUNP keyword paraseter on the SSET comauand, or 
a call to the CUINFO subroutine. The CP0 time and pages used in producing 
the dump are not included in the global linit specifications but are still 
charged to the user's account. 
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GLOBAL _AND_ LOCAL RELOCATION FACTORS 


A global relocation factor is maintained for referencing locations in 
virtual memory. Initially the global relocation factor is set to zero. The 
global relocation factor can be changed by the $SET command. 


A local relocation factor, which overrides the global relocation factor, 
can be given in the $ALTER, SDISPLAY, SMODIFY, SRESTART and $START commands, 
and remains in effect for the duration of the command, unless changed by a 
subsequent local relocation factor in the same command. A displacement 
given in the same command is added to the current value of the relocation 
factor to provide an absolute virtual memory address. This computed 
absolute virtual memory address is used by the command to reference the 
storage location or block of locations desired. 


MTS COMMANDS 


The following notation conventions are used in the prototypes of the 
commands: 


lower case - represents a generic type which is to be replaced by an 
item supplied by the user. 

upper case - indicates material to be repeated verbatin in the command. 

brackets [] - indicates that saterial within the brackets is optional. 

braces {} - indicates that the material within the braces represents 
choices, from which exactly one aust be selected. The 
choices are separated by vertical bars. 

dots ..- - indicates that the preceding syntactic unit(s) may be 
repeated. 

underlining - indicates the sinimus abbreviated form of the command or 
parameter. Longer abbreviations are accepted. 


_ The following pages give a complete summary of the commands in the MTS 
command language. 


Summary of MTS Command Prototypes 


SALTER location value ... ... 


location GRx 

FRx 

(RF={hhhhhh{GRx} ] xxxxxx 
value {hhhh{X *hhhh*} 

C*xxxx' 

F'yyyy‘ 

H'yyyy' 
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$CALC {expression |deciaal-number| hexadeciual~nuaber} 
$CANCEL ((*...*] [JOB] nnnnnn J ( (CCID{ ID} =xxxx ]PW=yyyvyyj] 
SCOMMENT [text ] | 

SCONTROL FDname control-command 

$COPY [( FROM] FDnane1] [{TO] FDnane2] 

SCREATE filename ( SIZE={n{nP({ntT} J ( TYPE=({LINE| SEQ(SEQWL} J 


$DEBUG [objectFDnane] [MAP{ =mapFDnane }] (NOMAP] [XREF] (I/OFDnanes] 
(lisits] [PAR=paraneters ]} 


SDESTROY filename [( OK{O.K.{!] 
SDISPLAY [ON FDname] [format] location ... 


format {HEX | NOHEX} 
{MNEM | NOMNEM} 
{BCD | EBCD | NOBCD {| NOEBCD} 
({SP1|{SSPCISGLS [SP2| DSPC{ DBLS} 
{ORL=S{ORL=L} 
location GRx 
FRX 
(RF= (hhhhhh{GRx} ] xxxxxx{...xxxxxx] 
PswW 
VMSIZE 
{$ {COST} 
SIGFILE 
({AFDNAME|AFD} 


$DUMP (ON FDnare] {format} ... 
format {HEX | NOHEX} 

({MNEH| NOMNEN} 
{BCD | EBCD | NOBCD | NOEBCD} 
{SP1|SSPC{SGLS {SP2{DSPC{ DBLS} 
(ORL=S|ORL=L} 
{LIB | NOLIB} 

SEDIT [ (filenane|:edit-command} } 

SEMPTY filename [OK{O.K.|!] 

SERRORDOMP 

$GET FDnane 

$SHEXADD operand operand ... 


operand {hhhh | GRx| RF} 
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$HEXSUB operand operand ... 
operand {hhhh (GRx | RF} 
S$INQUIRE parameter (/parameter] ... 


parameter A device-type 
ACTIVE 
ALL 
B 
C [signon-id| task-nunber ] 
CNTR 
CONFIG 
D device-nane 
EXEC [LOCAL|RMTS{ remote-station-id ] 
H 
HELD( HOLD 
JOB receipt=number 
L (S|MZ] 
LOCAL 
M 
ME 
MTS 
N 
0 
OS {signon-id|receipt-number] ALL] 
PAGES 
PLOT (signon-id|receipt-number|ALL] 
PRINT [ LOCAL| RMTS{remote-station-id] 
PRIORITY 
PUNCH [LOCAL{RMTS [remote~station-id] 
QUE [CNTR{EXEC(PRINT| PUNCH( ME remote~station-id| 
signon-id] 
receipt<-nusber 
renoteestation-id 
REMOTES[{RMTS 
Ss [1] 
SAME 
SIGMSG 
STATUS 
STRANDS 
T device-type 
TAPES 
task- number 
U signon~-id 
signon-id 
USERS 
*{ receipt=number] [ ME|signon-id } 


SLIST (FDname1] [{ ON] FDname2 ] 
S$LOAD [objectFDname] [MAP[=mapFDname ]] [NOMAP} [XREF] (1/OFDnanes ] 
{ limits] ( PAR=parameters } 
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limits PIME= (t (tS | tM} 
PAGES=p 
CARDS=c 
S$HODIFY location value ... ..- 
$HQUNT (request (; request]... ] 
SHET (*PDN*] [network-coamand ... ] 
SNUMBER [{ starting-number } [({, Jincrement ]({ CONTINUE] 
SPERMIT [filenane ( ALL {RUN {PRINO| NONEICNW{RO]) 
SRELEASE (*pdan* ] 
SRESTART ((AT] location] ( MAP{ =mapPDnane }] ( NOMAP ] ( XREF) ( I/OFDnames ] 


(limits) 
linits TIME= (t (tS (tH) 
PAGES=p 
CARDS=c 


SRUN [objectFDnane] ( SAP =mapFDnase]j] [ NOMAP] [ XREF] { I/OF Dnanses 
{lisits] (PAR=parameters ] 


lisits TIME= (tits tM} 
PAGES=p 
CARDS=c 


$SDS [ debug-comnand ] 
S$SET keyword ... 


keyword AFDECHO= {ON(OFF} 
CASE= (UC] LCEMX | MIXED} 
CMNDSKP= {ON (OFF} 
CONTCHAR=character 
COST= {ON| OFF} 
CREAFD= (ON | OFF} 
DEBUG= {ON | OFF} 
DEVCHAR=character 
ECHO= (ON | OFF} 
EDITAFD= (ON {OFF} 
EXDPILE= (ON{OFF | NEVER} 
ERRORDUMS P= (ON [OFF | FULL} 
FILEC HAR=character 
IC= (ON| OFF} 
LIBR= (OK {OFF} 
LIBS RCH= (OPF|] FDnare 
LNS=character 
PFIX= (ONf OFF} 
PW=characters 
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RF={hhhhhh(GRx} 
SCRFCHAR=character 
SEQFCHK={ON|OFF} 
SHFSEP=character 
SIGFILE= {OFF { FDname} 
SIGFILEATT N= {ON| OFF} 
SYMTAB= {ON (OFF} 

TDR= (ON| OFF} 

TER SE= {ON | OFF} 

TRIM= {ON| OFF} 
UNLOAD= (ON {OFF} 
*LIBRARY= {ON| OFF} 

$= (ON | OFF} 


$SIGNOFF [ SHORT|$] 


SSIGNON ccid [keywords] ['d name! ] 


keywords PW=password 
TIME= {t (ts [tM} 
PAGES=p 
CARDS=c 
COPIES=n 
PRINT={(QN{ TN} 
ROUTE=station 
CROUTE=station 
PROUTE=station 


SSINK {FDname | PFEVIOUS} 


SSOURCE {FDnamejPREVIOUS} 


$START (( AT] location] [MAP{=mapFDname]] [NOMAP] (XREF] [I/OFDnames] 
(limits ] 


(see SRESTART command) 
SUNLOAD [CLS=xxx ] 


SUNNUMBER 
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ALTEE 
COMMAND DESCRIPTION 
Purpose: To alter the contents of a general register, floating-point 


register, or specified virtual memory location(s). 
Prototype: SALTER location walue ... .+. 


Each alteration requires a pair of the following parameters, 
the first specifying what is to be altered and the second 
specifying the new contents. Any number of items may be 
altered with a single ALTER command. 


location 


"location" is the general register, floating-point 
register, or virtual memory location(s) that is to be 
altered. “location” may be given in one of the follow- 
ing forms: 


GRx 


GRkx specifies the genera] register "x", where 
"xy" is a decimal integer from 0 to 15 or a 
hexadecimal integer from 0 to 9, A to F. 


PRX 


PRx specifies the floating-point register "x", 
where "x" is one of the integers 0,2,4, or 6. 


( RF={hhhhhh[{GRx} ] xxxxxx 


This specifies a virtual semory location given 
by an optional local relocation factor and a 
displacenrent. "hhhhhh"® is the hexadecinal 
value of a local relocation factor or GRx 
indicates the general register whose contents 
are to be used as a local relocation factor. 
“xxxxxx" is the hexadecimal value of a displa- 
cement. The displacement is added to the 
current value of the relocation factor to 
provide an absolute 24=bit virtual nenory 
address. If a local relocation factor is not 
specified, the global relocation factor is 
used. The global relocation factor is ini- 
tially zero, but may be changed by the $SSET 
ccmamand. When a local relocation factor . is 
specified in the command, it remains in effect 
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Description: 
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for the remainder of the command unless subse- 
quently overridden by a second local reloca- 
tion factor specification. 


value 


The new contents are specified by any one of the 
following constant expressions: 


hhhh or X*hhhh* 


Any hexadecimal constant expression of any 
length may be given. 


C*xxxx! 


Any EBCDIC character expression of any length 
may be given between the delimiting primes; a 
prime in the character string must be repre- 
sented by two consecutive primes. 


Pfyyyy* or H*yyyy' 


A fullword (F) or halfword (H) decimal con= 
stant expression may be given consisting of a 
sign followed by decimal digits all enclosed 
in primes. The "#" sign is optional; the t=" 
sign is required. Decimal constants may not 
be specified for floating-point registers. 


The new constant given by the parameter “value" replaces the 
contents of the register or virtual memory location specified 
by "location", Register numbers and virtual memory addresses 
are checked for validity and a complaint is made if an 
illegal value is specified. At all times, a virtual naenory 
address less than 500000 (hexadecimal) is illegal. If a 
privileged program is currently loaded, all locations are 
illegal. The parameter pairs in the command are processed 
from left to right. 


General registers are altered as follows: 
A character constant is truncated or padded with trail- 
ing blanks to four bytes (characters) and placed, 
left-justified, into the register. 
The integer value of a hexadecimal constant (consisting 
of one to eight hexadecinal digits including leading 
zeros) is loaded, right-justified, into the register. 


The integer value of a decimal constant is loaded into 
the register. 
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Floating-point registers are altered as follows: 


A character constant is truncated or padded with trail- 
ing blanks to eight bytes (characters) and placed, 
left-justified, into the register. 


A hexadecimal constant is truncated or padded with 
trailing zeros to eight bytes and placed, lefte justified 
with leading zeros retained, into the register. 


Virtual memory is altered as follows: 


A character constant is placed, one character per byte 
into consecutive virtual memory locations. 


A hexadecinal constant is placed, two hexadecimal digits 
per byte with leading zeros retained, in consecutive 
meaory locations. If an odd number of hexadecinal 
digits is given, the last byte of memory altered has 
bits 4*7 set to zero. 


The integer value of a decimal constant is loaded, 
without regard to boundary alignment, into either four 
or two bytes (for fullword or halfword constants) 
starting with the byte specified by "location". 


Exaaples: SALTER GR3 TA3EO FRO X'411008 

The hexadecimal constant OOOTA3EO is placed in GR3 and 
the hexadecimal constant 4110400000000000 is placed in 
FR6. 

SALTER RF=5188E2 200 X*D502CC7E6900" 400 X'OSEF* GRA 0 
The hexadecimal constant D502CC7E6000 is placed in 
virtual memory location 518AE2, the hexadecimal constant 
OSEF is placed in location 518CE2, and the constant zero 
is placed. in GR10. 

$A RF=57A800 AEC F*'-1000" RF=519600 2B6 C'DON''T DO IT! 
The decinual constant ©1000 is placed in virtual aemory 


location S‘4B2EC, and the character constant DON'T DO IT 
is placed in location 5198B6. 
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Purpose: 


Prototype: 


Description: 
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CALC 
COMMAND DESCRIPTION 


To perform arithmetic as a desk calculator in double preci- 
sion, to evaluate arithmetic expressions containing decinal 
and/or hexadecimal nuabers, and to convert decimal integers 
to hexadecimal numbers and vice versa. 


$CALC [ {expression| number} ] 


where the parameter is an arithmetic expression when calcula- 
tion is to be performed, or a single hexadeciual number or 
decimal integer when conversion is to be performed. Blanks 
may occur anywhere within the expression or numbers, If the 
$ operand is used in the expression, the result from the 
previous CALC command is used in its place. 


A decimal number may be signed and contain an explicit 
exponent; for example, 


127) -2.2 +4 Te2 4.27e-8 .2,e+2 


A hexadecimal number is a string of 1 to 8 hexadecimal digits 
(O-F) enclosed in single quote marks and optionally preceded 
by the letter X; for example, 


X¥*503000" X*FF* "FF! X°PFFFFFFF' ‘130! 


When an arithmetic expression is the parameter, the expres- 
sion is evaluated. The order of precedence is left to right, 
exponentiation first, followed by multiplication and divi- 
sion, then fcllowed by addition and substraction, Both 
decimal and hexadecimal numbers say be used in the expres- 
sion. The permissible operators are: 


+ (addition) 

= (subtraction) 

* (multiplication) 

/ (division) 
Parentheses may also be used to define the order of prece- 
dence. A single hexadecimal number may be enclosed in 
parentheses to define it as an expression. 
If the parameter is a single hexadeciual number, it is 
converted to a decimal integer. If the parameter is a single 


decimal integer (no decimal point or exponent), it is 
converted to a hexadecimal integer, 
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Note that it is possible to interrupt an executing prograa, 
perform calculations, and then resume execution of the 
program via the SRESTART conmand. 


Examples: SCALC 22/7 
SCALC X*16*/7 
SCALC (2** (.5))* (1+1) 
SCALC $*3.5 
The above examples evaluate arithmetic expressions. 


SCALC 255 
SCALC -1 
The above examples perform hexadecinal conversions. 


SCALC ‘FFFPFFFF! 
SCALC X*FF* 
The above examples perform decigal conversions. 


SCALC $ 
The above example converts the result from the previous 


CALC command; if the result was in decimal, the conver- 
sion is in hexadeciaal, and vice versa. 
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Purpose: 


Prototype: 


Restrictions: 
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CANCEL 
COMMAND DESCRIPTION 


To cancel *PRINT*, *PUNCH*, OR *BATCH* jobs submitted froma 
terminal, or regular batch jobs that the user has previously 
submitted. 


SCANCEL (*...*] [{JOB]nnnnnn) [{ (ID(CCID}=xxxx ( PW=yyyyyy]] 
where the parameters may be given in any order. 
*...* nnannnn 


we,,.*" Gis either *PRINT*, *PUNCH*, or *BATCH*, and 
"nnnonn" is the 6-digit job receipt number. If the 
appropriate "*,..*" has not been released, then the 
associated job is cancelled. If the "*...*"* has been 
released tc HASP, then the job receipt must also be 
specified. If both the "*...*" name and the receipt 
Number are given, and the receipt number does not match 
the currently-opened "*,...*" job, then it is assumed the 
user is referring to an earlier “*,,..¥*" job and the 
cancel information is passed to HASP. If both the 
ue...*" name and the job receipt number are given but 
the receipt number is that belonging to a different 
n*,...*", an error comment is printed. 


{ID{(CCID} =xxxx [ PW=yyyyyy ] 


"xxxx" is the signon-id associated with the job to be 
cancelled. This is required only if it is different 
from the ccid that the user is signed on under when he 
issues the CANCEL command. The password "“yyyyyy" asso- 
ciated with the ccid must also be supplied. If it is 
not supplied the user is proapted for it. 


An *,..*" job cannot be cancelled once processing has begun 
by HASP. Thus, *PRINT* can be cancelled only if it is 
awaiting printing, *PUNCH* if it is awaiting punching, and 
*BATCH* if it is awaiting execution. To find out where a job 
is in processing, issue the MTS SINQUIRE command. 


Cancelling an *PRINT* or *PUNCH* job while it is still open 
causes the page-line or punch charges for the job to be 
rebated automatically. Once the job has been released to 
HASP, it can be cancelled (subject to the constraints listed 
earlier), but the charges are not rebated automatically. 
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Exaagples: SCANCEL *PRINT* 
The current *PRINT* job is cancelled. 
SCANCEL 610399 
The job with receipt number 610399 is cancelled. 
SCANCEL *PUNCH* 603321 


The *PURCH* job with receipt number 603321 is cancelled. 
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Purposes: 


Prototype: 


Description: 


Example: 
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COMMENT 
COMMAND DESCRIPTION 


To allow insertion of comments on output to the terminal or 
the printer. 


SCOMMENT (text ] 

This command is ignored by the system. As with all commands, 
it is echoed cn *SINK* and *MSINK* unless the command $SET 
ECHO=OFF has been given. 


$COM THIS IS A CCMMENT COMMAND 


- 
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CONTROL 
COMMAND DESCRIPTION 
Purpose: To allow the execution of control operations on certain types 


of files and devices. 
Prototype: SCONTROL FDname control-command 


Description: The "FDname" parameter specifies the file or device on which 
the control operation specified by the "control-comamand" 
parameter is to be performed. The “control-command" paramet=- 
er begins with the first non=-blank character after the 
"“Fpname® parameter and continues for the remainder of the 
command. 

Control commands may also be specified from user programs via 
the CONTROL subroutine which is described in Volume 3, 


Only certain types of files and devices currently allow 
control operations to be performed. A list of the acceptable 
devices and their control commands follows. The codes in 
parentheses refer to the device type returned by the subrou- 
tine GDINFO (see MTS Volume 3). 


Magnetic Tapes (STP) 


Control Command Parameter Function 
Positioning: 
REW Rewind 
FSR[ nj Forward space "n" records 
BSE[n } Backspace "n" records 
FSF[n] Forward space "n" files 
BSF{ nj Backspace "n*" files 
POSN {*n* (| *EOT* | name} Position to nth file, end- 
of=tape, or data set name, 
respectively 
Blocking: 


{FORMAT|FMT{RECFM} fat{ (size }{,lrecl)) j 
where "fmt" is [U(F(FBUFBSIVIVBIVS{ VBS} 

Specify blocking format 
and, optionally, block 
size and/or logical record 
length 

{SIZE(BLKSIZE} n Specify block size 
(18$nS$32767) 
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LRECL n Specify logical record 
length (1Sn< 32767) 
BLK {ON| OFF} Enable or disable blocking 


Label Processing: 


DSN ({ name ] Specify data set name for 


next new file written 
LP {ON|OFF} Enable or disable label 
processing 


Error Recovery: 


RETRY n Specify read error retry 
count (0<n<15) 


Miscellaneous: 


WIM(n ] Write "n" tape-marks 

MODE {(800({1600} Specify tape mode 

PUSH Push current tape paranme- 
ters into stack 

POP Pop tape parameters fron 
stack 


Note that in the FSR, BSR, FSF, BSF, and WIM parameters, "n" 
must be in the range from 0 to 32767. If omitted, "“n*" 
defaults to 1. For a complete description of these parame= 
ters, see the “Magnetic Tape Users Guide® in MTS Volume 4, 


Terminals (TTY, 2741) 


Control Command Parameter Function 
BDCST[ ={ON| OFF} ] Enable or disable printing 
of messages from the 
operator 
CC[= {ON{ OFF} ] Enable or disable carriage 
control 


COL={ON|OFF}[ ;la,rmj Print only a specified 
column range in output 
lines , 

DCC{= {x | ON{ OFF} ] Redefine the device conm- 
mand character; enable or 
disable recognition of 
device commands 

DLC[= (x{ON{ OFF) ] Redefine the delete-line 
character; enable or dis- 
able delete line function 

DPC[{= {x|ON{OFF} J Redefine the delete- 
previous character; enable 
or disable delete previous 
function 
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EFC(L= {x{ON|OFF} ] Redefine the end-of-file 
character; enable or dis- 
able end-of-file function 


GOLP=ddd_ Substitute typing elements 
for Selectric terminals 
HEX({ =(x{ON{ OFF} ] Enable or disable hexade- 


Cimal input editing; rede- 
fine the hexadecimal input 


delisiter 
JOB Retrieve line adapter and 
task nuabers 
K({ = {0C(LC} j Specify alphabetic conver= 
sion rode for input lines 
LEN= (n | OFF} Redefine the truncation 
length for output lines 
{LMNAR { RMAR}=n Define position of left 
and right sargin stops 
LNC[ = (x{ON[OFF} ] Redefine the literal-next 


character; enable or dis- 
able literal next function 


NOTE{ ={ON{ OFF} ] Enable or disable "twitch- 
ing" of type element 

RESET Reset all device command 
parameters 

REV{ = (ON | OFF} ] Enable or disable byte- 


reversal function 

{TABI (TABO}( =(ONI OFF} x(t }{ pt... J] 
Enable or disable logical 
tab stops; define logical 
tab character; establish 
positions of logical tab 
stops 

TERSE( =(ON(OFF} ] Enable or disable terse 
messages from the terminal 
device support routine 

UCTL=ON{ OFF} ] Enable or disable lower- 
case conversion for input 
lines 

UCOL = (ON FOF F} J Enable or disable lovwer- 
case conversion for output 
lines 

WARN= (ON | OFF} Enable or disable two 
minute warning on ten 
minute line 


The default values for the above parameters vary depending on 
the type of terminal being used. In cases where the equal 
sign is optional, if it is omitted, the switch setting is 
reversed. For a complete description of these paraszeters, 
gee the section "Memorex 1270 Device Support Commands" in MTS 
Volane 4. 
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NERIT Network (MNET) 


For 


Control] Command Parameter 
ATIN 


BIN={ON| PFF} 
CC={ONJOFF | CHECKS} 
(CLEAR| RESET} 


DON'T 


EOF 
HEX= (ON(OFF} [%x"] 
LEN=n 


PFX= {ON| OFF} 


TAB= {ON(OFF}[ "x" ][t1 t2 


UC={ON|(OFF} 


a complete description 


of 


Function 


Send an attention inter- 
rupt to the remote host 
Enable or disable binary 
translation for output 
Enable or disable logical 
carriage control 

Resets all control 
parameters 

Prevent a connection fror 
being released at signoff 
time 

Send an end-of-file to the 
remote host 

Enable or disable hexade- 
cimal translation 

Specify length of received 
records 

Enable or disable prefix 
processing 

Control processing of tab 
characters on input 
Enable or disable lower=- 
case conversion 


these parameters, see the 


section "MERIT Network Users Guide" in MTS Volume 4. 


SPRINTS (HPTR), SPUNCH* (HPCH), *BATCH* (HBAT) 


Control Command Parameter 


HOLD 

RELEASE 
CANCEL 
ROUTE=station 
NAME="d naae® 
PRINT=(QN| TN} 
COPIES=n 
PROUTE=station 
CROUT F=station 


Valid 
Pseudo-device Names 


*PRINT*, 
*PRINT*, 
*PRINT*, 
*PRINT*, 
*PRINT*, 
*PRINT* 
*PRINT* 
*PRINT* 
*PUNCH* 


*PUNCH*, *BATCH* 
*PUNCH*, *BATCH* 
*PUNCH*, *BATCH* 
*POUNCH* 
*PUNCH* 


For a description of these parameters, see the section "Batch 
Jobs From a Terminal" in this volume. 
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Exaaples: ScoNT 


SCOPY 
SCONT 
SROW 

Scout 
SENDF 
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ROL *TAPE* REW 


A REW control command is given the pseudo-device *TAPE* 
which is a 9=track magnetic tape. 


*SOURCE* CNITRLFILE 
ROL *SINK* LEN=100 
PROGRAMS SCARDS=INPUTDATA SPRINT=*SIWK* 
ROL *SINK* LEN=72 
ILE 


The file CNTRLFILE is established which can be used as a 
source file of commands for running a program ona 
Teletype. The CONTROL commands set the terminal output 
length to 100 characters for the duration of the program 
and then set the terminal output length to the default 
72 characters. This sequence of commands can be started 
with the command SSOURCE CNTRLFILE. 
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Purpose: 


Prototype: 


Description: 
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copy 
COMMAND DESCRIPTION 


To copy from a file or device to another file or device. 
SCOPY [{ FROM] FDname?] (([TO] FDname2] 

Two FDnames may be given as parameters: 

FDname1 


FDname1 specifies the file or device that contains the 
lines to be copied (the input). FDname1 may be an 
explicit concatenation of files and devices with line 
humber ranges. If FDname1 is omitted, the input lines 
are read frem the currently active file (*AFD*). 


FDname2 


FDname2 specifies the file or device that is to receive 
the copied lines (the output). FDname2 may be an 
explicit concatenation of files and devices with line 
number ranges. If FDname2 is omitted, the output lines 
are written on *SINK*, 


FROHK, TO 


FROM and TO are optional "directive" words. If a FROM 
or TO is present, it specifies that the following 
parameter is FDname1 or FDname2, respectively. If 
FDname1 is omitted or follows FDname2, TO must precede 
FDname2 or FROM must precede FDname1 (or both). If FROM 
or TO are used in an ambiguous or unusual manner, the 
command is not executed and an error comment is 
produced. 


The $COPY command is a series of read and write operations. 
It causes lines to be read sequentially from FDname1 and 
written on FDname2 until the end of the file or the end of a 
line number range is encountered on FDname1. 


For line files, the read operation uses the line numbers of 
FDname1. For sequential files and devices, the read opera= 
tion siaulates line numbers, although a beginning line number 
and increment may be specified for a device. For line files 
and devices, the write operation generates line numbers 
starting at 1 with an increment of 1 unless a beginning line 
number and increment is specified on FDname2. For sequential 
files, the write operation ignores line numbers and writes 
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the lines at the end of the file. If the @I modifier is used 
on FDnarge2, the write operation uses the line numbers fron 
the read operation for generating line numbers for the write 
operation. Hence, if an exact copy of a line file is wanted 
(each line number in FDname2 having the same line number as 
in FDnane1), the COPY command must be given in the form: 


$COPY FDnamel FDname2arI 


For line files (or sequential-with-line-nusbers- files), lines 
may be written on FDname2 sequentially or indexed. If a line 
file is written sequentially, renumbering of lines occurs; 
however, the user can specify the beginning line number and 
incresent for FDname2. For sequential files and devices, 
lines are written on FDname2 sequentially. If a line file is 
copied to a sequential file, the line numbers are lost. See 
the section "I/O Modifers" in the appendix to "Files and 
Devices" for a further description of the use of modifiers 
with read and write operations. 


A complaint is made if either FDnamel or FDname2 does not 
exist, is not available, or is the wrong type (output or 
input, respectively). 


SCOPY A TO B 


File A is copied to file B. Tf B is a line file, new 
line nuabers are generated for B starting at 1 and 
incrergjenting by 1. The line numbers from file A are not 
carried over to file B. 


SCOPY A Bar 


File A is copied to file B. The line numbers from A are 
retained in 8B. If A is a sequential file, these line 
numbers start from 1 and increment by 1. File B must be 
a line file (or a sequential-with-line-nuaber file). 


SCOPY A+B(5,20) C(10,,10) 
File A and lines 5 through 20 of file B are copied to 
file c. The line numbers of C start at 10 and are 
incremented by 10. 

$c A 
File A is copied to *SINK* (default). 

The following list of examples illustrates how the COPY 


comjaand behaves. "x* and "y" stand for any parameter; “a" 
and "b" stand for any parameter that is not FROM or TO. 
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SCOPY a "a" is copied to *SINK*. 
SCOPY FROM x "x" is copied to *SINK*. 
SCOPY TO y *AFD* is copied to “y", 
SCOPY a b "a" is copied to “b", 
SCOPY x TO y "xy" is copied to "y", 
S$COPY a FROM x "x" is copied to "a", 
SCOPY FROM x a "x" is copied to "a", 
SCOPY TO xa "a" is copied to "x", 


$COPY FROM x TO y "x" is copied to "y", 
SCOPY TO x FROM y "“y" is copied to "x", 


All other combinations of parameters are considered erroneous 
or ambiguous and cause an error comment to be produced. For 
example, 

SCOPY TO 

SCOPY FILE FROM 
Note that if the current file name character (initially #) is 


prefixed to FROM or TO, they lose their special 
interpretation. 
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CREATE 
COMMAND. DESCRIPTION 


Purpose: fo create either a permanent or temporary file. 
Prototype: SCREATE filename [keywords } 


Only the "filename" parameter giving the name of the file to 
be created is required. The other legal keyword paraaeters 
that may be given are: 


SIZE= {n({ nP{ nT} 


The SIZE keyword specifies the estimated size of the 
file to be created. The size may be given in one of 
three forms: 


n = the number of 40 byte lines, 
nP - the number of 4096 byte pages, or 
nT - the number of 7294 byte tracks. 


If the SIZE parameter is omitted, the default size of a 
permanent file is two pages or approximately 90 lines 
and the default size of a temporary file is 9 pages or 
approximately 700 lines, depending upon the format of 
the data. If this size is exceeded when the file is 
used, an attempt is sade by the system to extend the 
file. 


TYPE=(LINE[SEQ(SEQWL} 


The TYPE keyword specifies the type of file to be 
created. The type may be given in one of three foras: 


LINE - a line file is created, 

SEQ - a sequential file is created, or 

SEQWL - a sequential file with line numbers is 
created. 


If the TYPE keyword is omitted, the default type is 
LINE. 


Description: The SCREATE command can be used to create either a permanent 
or temporary file. The parameter "filename" gives the name 
of the file to be created. 


When the command has been given, MTS checks to make sure that 


a file of the given name does not already exist. A complaint 
is sade if the file already exists. Then MTS checks the 
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user's file space allocation to determine if he has enough 
space remaining to allow creation of the file. Lastly, MTS 
attempts to acquire the space for his. If all three steps 
are successful, MTS informs the user of the successful 
creation of the file. The file is empty when created and 
becomes the currently active file in the system (unless the 
command $SET CREAFD=OFF has previously been issued). The 
pseudo-device *AFD* is associated with the file. 


The SIZE parameter gives an approximation to the number of 
bytes that can actually be stored in the file. The actual 
capacity of the file is affected by the type of the file, the 
location of the file, and the length of the lines stored in 
the file. 


Since teaporary files are created automatically when first 
used as an FDname in a command or subroutine call, explicit 
creation of temporary files is necessary only when sonsething 
other than the default specifications are needed. 
SCREATE A 
The file A is created. Since there are no keyword 
parameters given, the file is a line file of default 
size, located on a disk. 
$CR -B SIZE=10P TYPE=SEQUWL 


The temporary file -B is created. The file is sequen- 
tial with line numbers and with a size of 10 pages. 
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DEBUG 
COMMAND DESCRIPTION 


To load a program and enter into debug command node. 


DEBUG (object¥FDnane ] [MAP ]=mapFDnane]] [FOMAP) ( XREF ] 
(I/oFDnanes] (limits ] [PAR=paraseters ] 


The following parameters may be given: 
object FDnane 


"YobjectFDnare* specifies the file(s) or device(s) con- 
taining the program to be loaded and debugged. If 
omitted the program is loaded from *SOURCE*. 


MAP(=mapFDnare)] [NOMAP] [XREF] 


The HAP and XREF parameters are used to obtain a load 
map and cross reference listing from the dynamic loader. 
These are not norgally needed when in debug mode. See 
the RUN command description for further details. 


I/OFDnares 


The keyword parameters "I/OFDnames" are the assignments 
of logical I/O units to files or devices for use by the 
loaded program during execution. The logical I/0 unit 
assignments establish the I/O subroutines which will be 
used by the loaded program for input and output of data. 
Where no specifications are stated, the following 
default assignaents occur: 


SCARDS=*SOURCE* 

SPRINT=*SINK* 

SPUNCH=*PUNCH*® (batch mode if global card est. > 0) 
SERCOM=*MSINK*® 

GUS ER=*MSOURCE* ¢ 


The logical I70 units 0 through 19 hawe no default 
specifications. See the section “Files and Devices" in 
this volume and subroutine descriptions for SCARDS, 
SPRINT, SPUNCH, SERCOM, GUSER, READ, and WRITE in Volunme 
3 for further details on the use of these subroutines. 


The logical 1/0 unit assignments may be initially 
assigned or reassigned in debug mode via the SET debug 
command. 
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FORTRAN users are reminded that MTS logical I/oO units 0 
through 19 are not necessarily the same as the FORTRAN 
logical I/O units 0 through 19. The FORTRAN IyoO unit 
routines may default the FORTRAN logical I/0 units 
independently of MTS. Moreover, if this has happened, 
the meaning of the units cannot be reassigned in debug 
mode. 


limits 


The keyword parameters "limits" specify local limits for 
tine, pages printed, and cards punched. See the RUN 
command description for further details. 


PAR=parameters 


The PAR keyword specifies an arbitrary string of charac 
ters to be passed to the loaded program. This is 
usually a parameter list for the program and its 
interpretation depends on the loaded progran. PAR 
keywords must be the last parameter field specified in 
the command. The parameter list is terminated by the 
end of the command line. Note that the parameter field 
always has a blank added after the last character and 
the count is incremented by one. 


The parameter list may be initially assigned or reas- 
signed in debug mode via the SET debug command. 


The DEBUG command calls upon the dynamic loader to load the 
object program into virtual memory. If there are unresolved 
external symbol references after loading from “objectFDnane", 
loading continues from *LIBRARY (the system library). Only 
those parts of *LIBRARY required to resolve the references 
are loaded. Tf there are still unresolved external 
references, a fatal loading error exists. In conversational 
mode, the loader prompts for more loader input; in batch saode 
an error comment is produced and the loading terminates 
inmediately. The search of the system library may be 
suppressed by the $SET LIBR=OFF command. SDS processes any 
symbol table information associated with the progran. 


If there were no fatal errors, control is transferred to 
debug command asode, In debug mode the user may use the 
facilities of SDS to display or modify parts of the loaded 
program and to initiate execution. SDS nonitors the perfor- 
mance of the program. See the section "Debug Mode" for 
further details on the use of SDS. 


The parameter string (specified by the PAR keyword) is passed 
as follows: GR1 contains the location of a fullword address 
constant which pcints to a region containing a halfword count 
(halfword aligned) followed by an EBCDIC character region (of 
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byte-length specified by the count) containing the parameter 
string. The left most bit of the address constant is 1. 


If files or devices specified by "“I/OPDnames* are non- 
existent or not available, the logical I/O unit referring to 
the unavailable file or device is set up in such a way that 
the first time the program being executed refers to the 
logical I/O unit, either the user is given the opportunity to 
respecify the FDname (in conversational mode) or execution is 
terminated (in batch mode). 


Exaarple: $DEBUG OBJPROG S=INPOUT 6=OUTPUT 
This loads the program OBJPROG and transfers control to 


debug mode. Logical I/O units 5 and 6 are assigned to 
the files INPUT and OUTPUT respectively. 
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DESTROY 


COMMAND DESCRIPTION 


To destroy a private file or a temporary file. 
DESTROY filename [ (OK{O.K.{!} ] 


The "filename" parameter specifies the name of the file to be 
destroyed. A complaint is made if the parameter is missing, 
or if the file specified does not exist, or if it is a public 
file. 


The destroyed file is deleted from the user's file catalog 
and the space occupied by the file is returned to the public 
domain. The user is informed when the file has been 
destroyed successfully. 


If the user is at a terminal, confirmation is requested 
before a permanent file is destroyed. Confirmation is not 
requested for temporary files. The command may be confirmed 
by the response "OK", "O.K." or %!", Any other response 
causes the command to be cancelled. The confirmation may be 
given as the seccnd parameter of the command. 


SDESTROY A 


This causes file "A" to be destroyed. The user is 
prompted for confirmation in conversational mode. 


SDESTROY B OK 
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DISPLAY 
COMMAND DESCRIPTION 


To display the contents of general registers, floating~point 
registers, the program status word, the user's virtual menory 
size, the accumulated cost of the current job, and/or 
specified virtual memory location(s). 


‘S$DISPLAY [ON FDnane] [format] location ... 


"location" is the only required parameter. As aany “loca- 
tion" and "forrgat" parameters may be given as desired. The 
only restriction on the order of parameters in the command 
line is that "ON FDname' must appear first if it appears at 
all. "format" parameters affect only the "location" parame=- 


ters which follow it. 


ON FPDnane 


"FDname" is the file or device to which the output from 
‘the SDISPLAY command is written. If "FDname"* is 
omitted, the output is written on ¥#SINK*. A complaint 
is nade if "FDname" specifies a non-existent or unavail=- 
able file or device. 


format 


The format of the display may be specified by any 
combination of the following option switches: 


HEX hexadecinal conversion 
NOHEX hexadecimal conversion off 


SNES mnemonic and hexadecimal conversion 
NOMNEM mnemonic and hexadecimal conversion off 


BCD EBCDIC conversion 
BBCD EBCDIC conversion 
NOBCD EBCDIC conversion off 
NOEBCD EBCDIC conversion off 


SP1 Single-spacing 
SSPC single-spacing 
SGLS single-spacing 
SP2 double~-spacing 
DSPC double-spacing 
DBLS aouble- spacing 
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ORL=S short output record (70 characters) 
ORL=L long output record (130 characters) 


If not specified, the following default option settings 
apply: 


NOHEX 
NOMNEM 
NOEBCD 
SP1. 
ORL=L 


T£ the NOHEX, NOMNEM and NOEBCD are all specified 
simultaneously (explicitly or by default), the output is 
with hexadecimal conversion. 


"format" parameters affect only "location" parameters 
that follow the "format" parameters and are blocks of 
virtual memory. They do not affect single memory 
locations or other itens. 


location 


"location" specifies what is to be displayed. This may 
be any of the following: 


GRx . 


GRx specifies the general register "x", where 
"x" is a decimal integer from 0 to 15 ora 
hexadecimal integer from 0 to 9, A to FP, or 
"sn if all general registers are to be 
displayed. 


FRX 


FRx specifies the floating-point register "x", 
where “"x® is one of the integers 0,2,4, or 6, 
or *S" if all floating-point registers are to 
be displayed. 


(RF= {hhhhhh|GRx} ) xxxxxx{...xxxxxx] 


This specifies a virtual memory location = or 
range of locations given by an optjona} local 
relocation factor and a displacement or range 
of displacements. “hhhhhh" is the hexadecinal 
value of a local relocation factor or GRx 
indicates the general register whose contents 
are to be used as a local relocation factor. 
"xxxxxx" is the hexadecimal value of a displa- 
cement. A range of displacements can be given 
by “"xxxxxXoooXXxXxxx", The displacement is 
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added to the current value of the relocation 
factor to provide an absolute 24-bit virtual 
memory address. If a local relocation factor 
is not specified, the global relocation factor 
is used. The global relocation factor is 
initially zero, but may be changed by the $SET 
ccmnand, When a relocation factor is speci- 
fied in the command, it remains in effect for 
the remainder of the command unless subse- 
quently overridden by a second local reloca- 
tion factor specification. 


PSR 
PSR specifies the program status word at the 
time the last loaded program terminated. 

VMSIZE 
VMSIZE specifies the current size of the 
user's virtual memory in a decimal number of 
pages. 

$ or COST 
Either $ or COST specifies the accumulated 
cost of the current job. This includes all 
charges up to the current time except per- 
manent file storage charges and charges for 
tapes still nounted. 

SIGFILE 


SIGFILE displays the current and new (if any) 
SIGNON files. 


APDNAME or AFD 


AFDNAME or AFD displays the name of the 
currently-active file or device. 


Description: The S$DISPLAY command displays general registers, floating- 
point registers, the program status word, the user's virtual 
memory size, the accumulated cost of the current job, and/or 
specified virtual memory locations, 


The general registers, floating-point registers and the PSw& 
are displayed in labeled hexadecimal format. 


Blocks of virtual memory are displayed in hexadecimal, 
gnenonic and hexadecimal, and/or EBCDIC format. 
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Whenever a "location" parameter is encountered in a SDISPLAY 
command line, it is processed immediately using the “format" 
parameters and relocation factor in effect at that time. 
“format and “location" parameters are processed from left to 
right in the command line. 


One ambiguity may occur. EBCD can represent either the EBCD 
option setting or a hexadecimal address displacement. It is 
interpreted as the EBCD option setting. To display the 
single location EBCD, OEBCD must be specified. 


SDISPLAY GR3 FRS EBCD 518E08...518FA6 


This displays GR3 and all the floating-point registers 
on *SINK* in single-spaced hexadecimal format, and 
displays virtual meaory locations 518EF08 through 518FA6 
(assuming a global relocation factor of zero) in single=- 
spaced EBCDIC format. 


$D ON DISPLAYFILE ORL=L GRS PSW VMSIZE 


This displays on the file DISPLAYFILE all the general 
registers, the progran status word, and the size of the 
user's virtual memory in long record hexadecimal format. 


$D MNEM EBCD SP2 RF=518000 200...480 NOMNEM NOEBCD 800...A80 


This displays virtual memory locations 518200 through 
518480 on *SINK* in double-spaced mnenonic, hexadecinal, 
and EBCDIC conversion format; and displays locations 
518800 through 518A80 in double-spaced hexadecimal 
format. 
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DUEP 
COMMAND DESCRIPTION 
Purpose: To display the contents of general registers, floating-point 


registers, the program status word, and the virtual memory 
locations associated with the user's current loaded progras. 


Prototype: $pumP [ON FDname] {format] ,.. 
As many "format" parameters may be given as desired. The 


only restriction on the order of paraaeters in the cosmand 
line is that "ON FDnase" must appear first if it appears at 


all. 

ON FDnane 
"Foname" is the file or device to which the output from 
the DUMP command is written. If "FDname" is onitted, 
the output is written on *SINK*. A complaint is made if 
"“PDname" specifies a non-existent or unavailable file or 
device. 

format 


The format of the display may be specified by any 
combination of the following option switches: 


HEX hexadecinal conversion 
NOHEX hexadecimal conversion off 


MNEM mneronic and hexadecimal conversion 
NOMNEM mnemonic and hexadecimal conversion off 


BCD EBCDIC conversion 
EBcD EBCDIC conversion 
ROBCD EBCDIC conversion off 
NOEBCD EBCDIC conversion off 


SP1 single-spacing 
SSPC single-spacing 
SGLS single-spacing 
SP2 double-spacing 
psPc double-spacing 
DBLS double-spacing 


ORL=S short output record (70 characters) 
ORL=L long output record (130 characters) 
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LIB dump all storage including library space 
NOLIB dump only non-library space 


If not specified, the following default option settings 
apply: 


NOHEX 
NCMNEM 
NOEBCD 
SP1 
ORL=L 
LIB 


If the NOHEX, NOMNEM and WNOEBCD are all specified 
Simultaneously (explicitly or by default), the output is 
with hexadeciaal conversion. If ORL=L is specified or 
defaulted, then both hexadecimal and EBCD conversion is 
given side by side. 


The $DUMP command displays the general registers, floating=- 
point registers, the program status word, and the virtual 
memory locations associated with the user's current loaded 
progras. 


The general registers and floating-point registers are dis- 
played in labeled hexadecimal format. 


Blocks of virtual memory are displayed in hexadecimal, 
mnemonic and hexadecimal, and/or EBCDIC format. 


Note that the NOLIB parameter does not work correctly unless 
the command “$SET SYMTAB=ON" is used before loading the 
prograr. 


SDUMP 


The general registers, floating-point registers, the 
program status word, and the virtual memory locations 
are displayed in single-spaced hexadecimal format on 
*SINK*. 


$DU HEX EBCD SP2 
The general registers, floating-point registers, the 
program status word, and the virtual menory locations 


are displayed in double-spaced hexadecimal and EBCDIC 
format. 
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EIT 
COMMAND DESCRIPTION 


To enter edit mode, invoking the context editor for making 
changes to a file. 


SEDIT ([ {filename|:edit-command} J 
The legal parameters are: 
filename 


"filename" is the name of a line file to be edited. The 
editor cannot be used on sequential files. See the 
"Edit Mode*® section for a description of the context 
editor and the editor coamand language. 


edit-comaana 


“edit-command" is any single edit mode command. It sust 
be preceded by a colon ":*, 


Tf "filename" is specified, and if EDITAFD is ON (see the 
SSET command), “filename* becomes the currently active file 
(*A FD). If "filename" is omitted, or if “sedit-command" is 
specified, the following procedure is used to determine the 
file to be edited. 


1) If the editor has not previously been used, or if the 
editor was last terminated by the edit mode command 
"STOP", the user is prompted for the file name. 


2) If the editor was last terminated by the edit mode command 
"MTS", and 


a) EDITAFD is OFF, the file last specified on a $EDIT 
command is used. If this file is no longer available, 
an error message is produced. 


b) EDITAFD is ON, the currently active file (*AFD*) is 
used. If there is no currently active file, the user 
is prompted for the file name. If no paraseter is 
given, the user is prompted to enter parameters until 
the parameter "MTS* is given. 


If any of the above error conditions exist, the user is 
prompted to enter a file nare. 


SEDIT DATAFILE 
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The context editor is invoked to edit the line file 
DATAFIle. 


SEDIT :CBANGE 10 ‘A'B* 
This command changes the first occurrence of the charac 
ter A in line 10 of the currently active file to the 


character 8B and then returns to MTS command mode. It 
Bust be preceded by a *:", 
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Description: 
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EMPTY 
COMMAND DESCRIPTION 


To enpty the contents of a file without destroying the file. 
SEMPTY filename [{ (OK[O.K.4!} ] 


The "filename" parameter specifies the name of the file to be. 
emptied. A complaint is made if the parameter is missing, if 
the file specified does not exist, if the file is a public 
file, or if the file is a read-only file. 


The current contents of the file "filename" are discarded. 
The user is informed when the file has been erptied success- 
fully. The space occupied by the file is not released, a 
catalog entry still exists for the file, and the user 
continues to be charged for it. 


If the user is at a terminal, confirmation is requested 
before a permanent file is emptied. Confirmation is not 
requested for scratch files. The command may be confirmed by 
the response "OK", "O.K.", or "!", <Any other response causes 
the command to be cancelled, The confirmation may be given 
as the second parameter of the command. 


SEMPTY A 


SEMPTY B OK 
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ERRORDUMNP 
COMMAND DESCRIPTION 


To allow automatic program dumps in batch mode in case of an 
abnormal program termination. 


SERRORDUMP 


If an executing program terminates abnormally, a dump of the 
registers and program storage region is given. Common 
abnormal terminations are a program interrupt, a call to the 
subroutine FRROR, and exceeding global or local time, page, 
or card estimates. This command is equivalent to the command 
$SET ERRORDUMP=ON. 


This command has no effect in terminal mode since dumps are 
never automatically produced. Terminal users may use the 
DUMP, DISPLAY, or debug mode DISPLAY commands to inspect all 
or parts of virtual memory. A sygbolic program dump may be 
obtained via the symbolic debugging system facilities in a 
Similar manner. For details, see the "Debug Mode" section in 
this volume. 


SER 
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Sit 
COMMAND DESCRIPTION 


To establish a file or device as the currently active file. 
SGET FDnane 


The "FDnarge” parameter specifies the name of the file or 
device to becerze the currently active file. The file or 
device is opened and the pseudo-device *AFD* is associated 
with that file or device. A coaplaint is s,ade if the 
parargeter is omitted, if the file or device does not exist, 
if the file is a read-only file, or if the device is an input 
device. The previously active file is released even if one 
of these error situations exists. The line number for the 
SNUMBER CONTINUE command is reset to one. 


SGET A 
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HEXADD 
COMMAND DESCRIPTION 


To perform hexadecimal addition in command mode. 

SHEXADD operand operand ... 

One or more operands separated with intervening blanks are 
given with the command. Each operand may be given in one of 
the three following forms: 

hhhh A hexadecimal number to be used as an operand. 


GRx A general register whose contents is to be used as 
an operand. 


RF The current global relocation factor. 


The hexadecimal numbers or the contents of the registers 
specified by the operands are added. Overflows are ignored. 


The results of the HEXADD command appear in the form: 
SUM = XXXXXXxx 


#hexadd 1a2 2e814 
#SUM = 2ESBF 


In this terminal mode exanple, the hexadecimal numbers 
1A2 and 2E81D are added together to produce the sua 
2E9BF. 
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HEXSUSB 
COMMAND DESCRIPTION 


To perform hexadeciual subtraction in command sode. 

SHEXSUB operand operand ... 

One or more operands separated with intervening blanks are 
given with the command. Each operand may be given in one of 
the three following forns: 

hhhh A heradecinmal namber to be used as an operand. 


GRx A general register whose contents is to be used as 
an operand. 


RF The current global relocation factor. 

The second and all following operands are subtracted from the 
first operand. Negative results are given with a minus sign 
preceding the absolute value of the difference. 

The results of the HEXSUB command appear in the foram: 


DIFF = XxXxxxxxx 


thexs 2e9bf 1a2 
DIFF = 2ES1D 


In this terminal examaple, the hexadecinal number 1A2 is 
subtracted from 2E9BF to produce the difference 2E81D. 


thexs 1e57e 1a2 5Sbe 
#DIFF = 1DE21 


In this example, 1a2 is subtracted from 1te57e, and 5bc 
is subtracted froa this result. 
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INQUIRE 

COMMAND DESCRIPTION 
To display the current status of a batch job, an execution 
queue, a print queue, a punch queue, plotting jobs, OS batch 
jobs, UMMPS jobs, or other system activity. 
SINQUIRE parameter [/parameter] ... 
The output for this command falls into five categories 
discussed after the list of parameters. One of the following 
parameters must be given. The minimum abbreviation (if any) 
of each parameter is underlined. 


Batch Jobs 


CTIVE : 
Information about all the active batch jobs is printed 
in Output Type 1 format. 


Tnformation about all MTS batch tasks is printed in 
Output Type 4 format. 


{HELD| HOLD} 
Information about all batch jobs that are held is 
printed in Output Type 1 format, 


JOB receipt=nunmber 
Information on the job with the specified receipt nuaber 
is printed in Output Type 1 format. This form should be 
used if the receipt number is less than 5 digits in 
length. 


ME 
Information about all jobs submitted by the signon id 
signed on is printed in Output Type 1 format. All jobs 
not yet completed or completed in the last 96 hours are 
listed. 


OS ( signon-id|six-digit-receipt-number| ALL] 
Information about the OS batch queue is printed in 
Output Type 1 format. If any batch job is found that 
fits the search criterion, it is displayed. Position in 
the queue gives the initiator class for the job. The 
last line of output prints the total number of jobs and 
records currently in the 0S batch queue. 
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Search criterion can be 


1) a particular signon id 

2) a particular receipt number 

3) all jobs 

4) no jobs (no second operand); just gives summary. 


PLOT ([ALL{receipt=-nuamber|signon-id ] 
Information about the PLOT queve is printed in Output 
Type 1 format. If a plot job is found that fits the 
search criterion, it is displayed. The last line of 
output gives the total nuaber of jobs and time to plot 
the jobs queued. 
Search criterion can be: 
1) a particular signon id 
2) a particular receipt number (does not include 
destination code) 
3) all jobs 
4) no jobs (no second operand); just gives summary. 
receipt-nuagber 
Information about the job with the specified receipt 
number is printed in Output Type 1 format. 
SAME . 
Information about the job last asked about via the 
receipt nuaber is printed in Output Type 1 format. 
signon-id 


Inforrgation about all jobs submitted under the specified 
signon id is printed in Output Type 1 format. Both 
unfinished jobs and jobs finished within the last 96 
hours are included. 


*{ receipt<-number ] [ME|signon-id ] 
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This parameter prints information about all jobs not yet 
completed by the signon id who is making the request (if 
the second operand is omitted or MZ was specified), or 
inforaation about jobs submitted by the signon id 
specified. In addition, all completed jobs belonging to 
the user that have completed whose receipt nuaber is 
greater than or equal to the receipt number specified 
are indicated. If a receipt number is not specified, 
the starting point is 600000 which is the lowest 
*BATCH*, *PRINT* or *PUNCH* receipt number. 
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CNTR 


EXEC 


LOCAL 
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A summary is printed in Output Type 3 format of each 
queue for all jobs in the batch queue. 


A summary of each queue counting only jobs with output 
routed to the Computing Center is printed in Output Type 
3 format. 


( LOCAL{RMTS (rermote-station-id ] 
The execution queue summary is printed in Output Type 3 
format for the following second operands: 


1) jobs routed to the center if CNTR or LOCAL is 
specified 

2) jobs routed to remote stations if RMTS is 
specified 

3) jobs routed to the specified remote station 

4) all jobs if no second operand is specified. 


A summary of each queue counting only jobs with output 
routed to the Computing Center is printed in Output Type 
3 format. 


PRINT [ LOCALERMTS|renote-station-id ] 


The print queue summary is printed in Output Type 3 
format for the following second operands: 


1) jobs to be printed at the center if CNTR or 
LOCAL is specified 

2) jobs routed to remote stations if RMTS is 
specified 

3) jobs routed to the specified remote station 

4%) all jobs if no second operand is specified. 


PUNCH [LOCAL|RMTS(remote-station-id ] 


QUE 


The punch queue summary is printed in Output Type 3 
format for the following second operands: 


1) jobs to be printed at the center if CNTR or 
LOCAL is specified 

2) jobs routed to remote stations if RMTS is 
specified 

3) jobs routed to the specified remote station 

4) all jobs if no second operand is specified. 


The QUE parameter prints information in Output Type 2 
and 3 formats for the following second operands: 
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Gives limited information about all jobs 
not yet completed in the batch queue and 
a queue summary. The information printed 
by the USERS parameter is first printed. 
Gives limited information about all jobs 
not yet completed in the PRINT queue and 
a queue summary. 
Gives limited information 
not yet completed in the 
a queue summary. 

Gives limited information about all jobs 
not yet completed in the execute queue 
and a quevte summary. 

Gives liaited information about all jobs 
not yet completed whose output is routed 
to the Computing Center and a queue 
summary. 


about all jobs 
punch queue and 


renote-station-id 


signon-id 


Note: 1) 
2) 
3) 


4) 


Gives limited information about all jobs 
not yet completed whose output is routed 
to the specific remote station anda 
queue summary. 

Gives limited information about all jobs 
not yet completed that were submitted by 
the specified signon id and does not give 
a queue suamary, 

Gives limited igformation about all jobs 
submitted by the signon id that is making 
the inquiry and have not yet been 
completed. 


Any combination of 
valid for a single 
Only one (the last 
valid for a single QUE command. 

Only one (the last found) signon id is valid 
for a single QUE command. 
Type of queue, location and 
appear in any corbination 
command. 


PRINT, PUNCH 
QUE command. 
found) remote station id is 


and EXEC is 


signon id may. 
in a single QUE 


renote-station-id 


A sunmary 


of each queue counting only jobs routed to 


that rerote station is printed in Output Type 3 format. 


{REMOTES {RNTS} 
A summary 


of each queue counting only jobs routed to 


remote stations is printed in Output Type 3 format. 
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Devices 


A device-type 
This parameter prints a list of available devices of the 
type specified. 


CONFIG 
The number of storage modules (SSU0), channel controllers 
(CCU), central processors (CPU), readers, printers, tape 
drives, and punches attached to the system is printed. 


D device-nane 
Information about the task that owns the device speci- 
fied is printed in Output Type 4 format. 


L (SIMZ] 
This parameter produces a list of started phone lines in 
one of three ways: 


1) If second operand is null, a list of all phone 
lines started. 

2) If second operand is S, a list of all phone 
lines started and the signon id of each user on 
each line. 

3) If second operand is M2, a list of only nez- 
zanine phone lines. 


T device-type 
This parameter indicates what units are available for 
usage by tasks. All units offline are indicated and 
information about all tasks owning a device of the 
specified type is given. 


This is an alternate form of the command A 9TP. 


C [ task-nunber{signon-id ] 
The task number, signon id, and CPU time used by the 
current user is printed for MTS tasks selected by one of 
the following second operands: 


1) task number 


2) signon id 
3) batch jobs (if no second operand). 


Information about all HASP and HASPLING tasks is printed 
in Output Type 4 format. 
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MN ; 
Information about all active MTS tasks is printed in 
Output Type 4 format. 

N 
Information about all active non-MTS tasks is printed in 
Output Type 4 format. 

0 
Information about all operator console tasks is printed 
in Output Type 4 format. 

S (L] 
This parameter prints a list of all users currently 
signed on. 

task-nuaber 


Information about the task whose number is specified is 
printed in Output Type 4 format. This number can only 
be between the nurabers 1 and 9999. If the number 
specified has more than 4 digits it is taken to be a 
receipt nuaber. 


U signon-id 
This parameter prints information about the task owned 
by the specified signon id. 


Systea 


PAGES 
This paramgeter lists the signon ids of all users 
currently connected to the system and the current number 
of pages of virtual memory the user has acquired. If 
the signon id and the number of pages is separated by a 
dash (=), the task is conversational; if separated by a 
colon (:), the task is batch. 


PRIORITY . 
This parameter prints the table used to determine the 


priority for executing and printing batch jobs. For 
execution of jobs, only the estimated execution time is 
used to determine the priority. For printing of jobs, 
the actual number of pages to print is used. For a 
given priority, the maxinum execution time and number of 
printed pages are given. The table produced by this 
command supersedes all tables published in any Computing 
Center documentation. 


SIGMSG 
This causes the current signon message to be printed, 
along with the mesage's length. This is useful when the 
signon sessage exceeds the terminal's default length and 
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the user would like to know what the entire message is. 
A SLEN command should be issued before issuing the 
INCUIRE command. 


STATUS 


STRAN 


USERS 


Information about the status of the system is printed. 
This includes the mode that the system is in (attended 
or unattended, all batch execution held or released), 
the number of users signed on (see the USERS parameter 
betow), and the batch backlog (see the ALL command). 


DS 

Information about batch processors is printed. The 

output contains two types of entries. The fora: 
JJ=PPp-Ss 


is common to both types of entries. 


JJ is the maximum number of active MTS jobs that 
allow this processor to execute a batch job. 


PP is the lowest priority job that this processor 
executes. 


SS is the first priority level to be searched for 
an available batch job. 


Processors not only execute a job, but also act as a 
transport system between MTS and HASP for batch input 
and printed and punched output. 

JJ@PP-SS:TT = receipt=number signon-id 
This form is used when a _ processor is active. It 
contains the information mentioned above along with the 
job number and the user being serviced. The type of 
function being accomplished by the processor is 

TT = EX if a batch job is being executed; 


BA if a batch job is being read in via. 
*BATCH*; 


PR if a listing is being queued for printing 
via *PRINT*; 


PU if a deck of cards is being queued for 
punching via *POUNCH*, 


This parameter prints the number of MTS tasks, conversa- 
tional users, batch users, idle lines, pages of virtual 
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memory, and the number of pages of real memory being 
used. Also the percent of used HASP secondary storage 
is given. When this percentage is very high (over 85%), 
users should refrain from using the *PRINT*, *BATCH*, 
and *PUNCH*® facilities. 


Other 
NTS 


This parameter returns to command mode. 


Description: Pive types of output are available from the SINQUIRE comsmand. 
Four types apply to several parameters, and are discussed 
here; the last type is parameter specific and is discussed 
with the specific parameter. 


Type 1. Gives detailed inforaation about a batch job's 
status, as it currently appears in one of the three 
batch queues (execute, print or punch), or as it appears 
in a file of finished jobs. The output takes one of the 
following forms: 


1) JOB receipt-number signon-id (location) IS HELD IN 
function QUEUE, BECAUSE reason 


This measage indicates the job was held for the reason 
given. 


2) JOB receipt-numaber signon-id (priority) IS function 
(location) 


This job is currently being printed or punched at the 
location specified. 


3) JOB receiptenumber signon-id (priority) EXECUTION 
TASK nampber USED number SEC. 


This job is currently executing as the task nuaber 
given, and has used the indicated number of seconds. 


4) JOB receipt-numsber signon-id HAS number PAGES AT 
Loc. location (delivery-code) date-finished 
tine-finished 


This job has finished all its scheduled functions on the 
date and time specified. The number of pages printed 
and punched output (if the word CARDS occurs after the 
time finished) is waiting for the user at the rerote 
Station or the delivery location indicated. 


Please note, the time finished indicates when the 
computer has finished processing the job. This does not 
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reflect in any way the time it takes to separate, 
deliver, or distribute output, which must be done by 
humans. Also, jobs with large volumes of output routed 
to remote stations (as well as shorter jobs when large 
remote printing backlogs exist) are printed at the 
Computing Center and delivered to the remote stations. 
Thus the remote station and delivery code only indicate 
where the output eventually comes to rest. Production 
Control should be contacted about any confusion over 
remote stations and delivery codes. 


5) JOB receiptenuaber signon-id (priority) IS IN POSI- 
TION number ON THE function QUEUE location 


WAITING FOR: nuagber (priority) { number 
(priority) ...] 


The job is waiting for the service indicated. Its 
number in line is given. If there are jobs scheduled 
ahead of it, the nuaber of jobs at each priority level 
ahead of the specified job are listed on a second line. 


2. Gives abbreviated information about several jobs on 
a single print line. The number of jobs per line 
depends upon the device's line length. 


signon-id receipt-nuasber priority location- 
indicator type position 


The signon id, receipt number, priority, and position of 
every job still requiring processing is listed. 


‘The codes for type are: 


EXEC = actively executing 

EX = queued for execution 

PRINT - actively printing 

PR = queued for printing 

PUNCH = actively punching 

PU - queued for punching 

HELD - currently held for some reason 


The location indicator code is blank for local and '>* 
for remote jobs. 


3- Gives a summary of all jobs currently ina particu- 
lar queue. 


type QUEUE (location:amount) number ACTIVE number 
QUEUED: number (priority) number (priority)... 
Number (HELD) 
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"type" is EXECUTE, PRINT or PUNCH. 


"location" indicates what locations within the queue are 
included. 


"amount" 

1) is null or indicates EXECUTION IS HELD in the 
EXECUTE QUEUE. ; 

2) indicates the total number of cards to be 
punched for all queued jobs in the PUNCH QUEUE. 

3) is the number of QN and TN print train pages to 
be printed for all queued jobs in the PRINT 
QUEUE. 


The number of active and queued joba are indicated. For 
each non-empty priority level, the number of jobs at 
that priority are given. The nurgber of jobs that are 
held are indicated. 


4. Gives information about a particular task. 


task-nunber number-of-virtual-pages receipt-number 
job<-table-address parameters devices-owned 


The number of virtual pages allocated by the task is 
present only for virtual tasks, The parameters for MsTS 
include signon id, project nuaber, and receipt number if 
a batch job. 


$I ME 


This prints out information about all the user's 
finished and unfinished jobs occurring in the last 


96 hours. 

$I 

609839 

SAME 
INQUIRE stores the receipt number of the last asked 
about job for the current signon session. This 
sequence is useful if it becomes important for a 
user to determine when a particular job is 
finished. 

$I USERS 


This prints out information concerning the present 
systen load. 
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List 
COMMAND DESCRIPTION 


To list a file or device onto another file or device with 
line nuabers. 


$LIST (FDname1] ((ON] FDname2]j 
Two FDnames may be given as parameters: 
FDnaaet 


FDname1? specifies the file or device that contains the 
lines to be listed (the input). FDname1 may be an 
explicit concatenation of files and devices with line 
nuaber ranges. If FDnamel is omitted, the input lines 
are read from the currently active file (*AFD*). 


FDname2 


FDname2 specifies the file or device that is to receive 
the listed lines (the output). FDname2 may be an 
explicit concatenation of files and devices with line 
number ranges. If FDname2 is omitted, the output lines 
are written on *SINK*. 


ON 


ON is an optional "directive" word. If FDnamet is 
omitted or follows FDname2, ON must precede FDname2. 


The LIST command is a series of read and write operations. 
It causes lines to be read sequentially from FDname1 and 
written on FDnase2 until the end of the file or the end of a 
line number range is encountered on FDname1. The line number 
returned from the read operation on FDname? is converted to a 
12 character EBCDIC number and appended on the front of each 
line. This extended line is written on FDnane2, 


The LIST command uses line numbers and modifiers for the read 
and write operations in the same manner as in the COPY 
command. 


A complaint is made if either FDname1 or FDname2 does not 


exist, is not available, or is the wrong type (output or 
input, respectively). 
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$LIST A 


File A is listed on *SINK* (default). If A is a line 
file, the line numbers froma file A are appended to 
output lines before they are written on *SINK*. If file 
A is a sequential file, line numbers starting at 1 and 
incresenting by 1 are appended to the output lines. 


SLIST a(5,20) B 


Lines 5 through 20 of file A are listed on file B. The 
line numbers from A are appended as above. 


$L 


The currently active file or device *AFD* (default) is 
listed on *SINK* (default) with line numbers appended as 
above. 


The following list of examples illustrates how the LIST 
command behaves. “x" and "y" stand for any parameter; ‘“a" 
and *b" stand for any parameter that is not ON. 


SLIST a "a" is listed on *SINK*. 
$LIST ON x *AFD* is listed on "x". 
$LIST a ON b ta" is listed on "b*. 
$LIST a b "a" is listed on "b*". 
$LIST ON a x "x" is listed on "a". 


All other combinations are considered erroneous or aagbiguous 
and cause an error coarment to be produced. For exaagple, 


$LIST ON 


Note that if the current file nage character (initially #) is 
prefixed to ON, it loses its special interpretation. 
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Purpose: 


Prototype: 
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LOAD 
COMMAND DESCRIPTION 


To load a program without initiating execution. 


SLOAD [objectFDname] [MAP[ =mapFDname]] (NOMAP] [XREF] 
(I/OFrDnames] [limits] { PAR=parameters ] 


The following parameters may be given: 
object FDnanze 


“objectFDname" specifies the file(s) or device(s) ‘con= 
taining the program(s) to be loaded. If omitted, the 
program is loaded from *SOURCE*, 


MAP[ =mapFDname} (NOMAP] [ XREF } 


The MAP keyword specifies the file or device "mapFDname" 
on which the loader is to write the load map. If the 
MAP keyword parameter is omitted, no load map is 
written. If the MAP keyword is given in the form of 
MAP, “mapFDname" defaults to *SINK*, The NOMAP paramet= 
er suppresses the printing of the load map. NOMAP need 
be given only if a previous MAP specification was made. 


The XREF parameter specifies that a cross reference 
listing of external symbols occurring in the loaded 
programs is to be produced in addition to the load map. 
If XREF is given without the MAP keyword, MAP=*SINK* is 
-assumed, If XREP is given with NOMAP, only the cross 
reference is produced. 


I/OFDnames 


The keyword parameters "I/OFDnames" are the assignaents 
of logical I/O units to files or devices for use by the 
loaded program during execution. The logical I/0 unit 
assignments establish the I/0 subroutines which are used 
by the loaded program for the input and output of data. 
Where no specifications are stated, the following 
default assignments occur: 


SCARDS=*SOURCE* 

SPRINT=*SINK* 

SPUNCH=*PUNCH*® (batch mode if global card est. >0) 
SERC OM =*MSINK* 

GUS ER=*MSOURCE* 
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The logical I/0 units 0 through 19 have no default 
specificaticns. See the section “*Piles and Devices" in 
this volume and the subroutine descriptions for SCARDS, 
SPRINT, SPUNCH, SERCOM, GUSER, READ and WRITE in Volume 
3 for further details on the use of these subroutines. 


FORTRAN users are reminded that MTS logical I/0 units 0 
through 19 are not necessarily the same as the FORTRAN 
logical I70 anits 0 through 19. fhe FORTRAN .1/0 
routines may default the FORTRAN logical I/C units 
independently of MTS. Moreover, if this has happened, 
the meaning of these units cannot be reassigned by a 

RESTART command. 


linits 


The keyword parameters "liaits" specify local limits for 
CPU tise, pages printed and cards punched. These can be 
given in the form: 


TIME=(t(tSjtm} 
PAGES=p 
CARDS=c 


These local limits can be used in both batch and 
terminal mode and are effective only for the execution 
of the program loaded by the LOAD command. See the 
description of the similar global limits in the SSIGNON 
command description for further details of limit 
specifications. 


PAR= parameters 


The PAR keyword specifies an arbitrary string of charac- 
ters to be passed to the loaded program on initiation of 
execution. This is usually a parameter list for the 
program and its interpretation depends on the loaded 
program. The PAR keyword must be the last parameter 
field specified in the command. The parameter list is 
terminated by the end of the command line. 


Description: The LOAD command calls upon the dynamic loader to load _ the 
object program into virtual memory. If there are unresolved 
external syabol references after loading from “objectFDnane", 
loading continues from *LIBRARY (the system library). Only 
those parts of *LIBRARY required to resolve the references 
are loaded, If there are still unresolved external 
references, a fatal loading error exists. In terminal node, 
the loader prompts for more loader input; in batch mode, an 
error comment is produced and the loading terminates innedi- 
ately. The search of the systema library may be suppressed by 
the $SET LIBR=OFF command. If $SET DEBUG=ON has been 
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specified, SDS processes only symbol table information asso- 
ciated with the loaded progran. 


After the program is loaded, control is returned to the user 
in command mode. The user can then use SDS or the commands 
$DISPLAY and SALTER to display and modify parts of the loaded 
program. Execution of the program can be initiated by the 
S$START command or by the debug mode RUN command. 


The parameter string (specified by the PAR keyword) is passed 
as follows: GR1 contains the location of a fullword address 
constant which points to a region containing a halfword count 
(halfword aligned) followed by an EBCDIC character region (of 
byte-length specified by the count) containing the parameter 
string. The leftmost bit of the address constant is 1. 


If files or devices specifed by "Iy/OFDnames" are non-existent 
or not available, the logical I/0 unit referring to the 
unavailable file or device is set up such that the first tine 
the program being executed refers to that logical I/o0 unit, 
either the user is given an opportunity to respecify the 
FDname (in terminal mode) or execution is terminated (in 
batch mode). 


$LO OBJPROG+PROGLIB MAP 5=INPUT 6=OUTPUT 


This loads the program and a private library in CBJPROG+ 
PROGLIB. A load map is printed on *SINK*. Logical I/0 
units 5 and 6 are specified for the input and output of 
data during a later execution of the program which can 
be initiated by the START command or by the debug mode 
RUN command. 
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BODIPY 
CCHMAND DESCRIPTION 
Purpose: To alter the contents of a general register, floating-point 


register, or specified virtual memory location(s). 


Prototype: SHODIPY location value ... 


This command is identical to the SALTER command. 
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Purpose: 


Prototype: 


Description: 
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MOUNT 


COMMAND DESCRIPTION — 


To mount magnetic tapes or MERIT network connections. 
$MOUNT [request [; request] ... ] 
request 


"request" is the mount request for the item to be 
mounted. One or more requests separated by semicolons 
may be entered directly on the SMOUNT command. If the 
requests are omitted from the command line, they must be 
entered as separate input lines following the command 
(read from *SOURCE*) until terminated by an end-of-file. 


The form of the request for mounting magnetic tapes is: 
racknumber [ON] 9TP [PNAME=]*pdn* { keywords] ‘external id' 


The form of the request for mounting a MERIT network 
connection is: 


MNET [ PNAME=]*pdn* [keywords ] 


For mounting magnetic tapes, the user must specify a rack 
number and an external identification. The rack number is 
the location number of the tape reel in the Computing Center 
tape library. The ‘external id‘ is the name associated with 
the external label. This label is typed on a gummed sticker 
and is attached to the reel when it is initially assigned to 
a user or submjtted to the Computing Center. Tf the 
information between the single quotes cannot be judged by the 
computer operator as reasonably corresponding to the external 
identification on the tape, the operator informs the user 
that the tape is unavailable. If a scratch tape is to be 
mounted, the word POOL must be used in place of the rack 
number and no external identification is required. 


The user must specify a device type which indicates on which 
type of device the item is to be mounted. The device types 
available are: 


OTP - 9=-track magnetic tape 
MNET =- MERIT network connection 


The user must specify a psuedo-device name "pdn" for each 


item to be mounted. After the item is mounted, all command 
and program references to the item are made using its "pdn", 
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rather than the name of the actual device on which the iten 
is mounted. The "pdn" is used in the same context as a file 
or device name (FDname). A "pdn" begins with an asterisk, 
ends with an asterisk, has from one to fourteen characters in 
between, and must not conflict with pre-defined MTS "pdns" 
such as *SOURCE*, *SINK*, and so on, (See the section on 
pseudo-device names in "Files and Devices* in this voluae.) 


The user may specify many different keyword parameters as 
part of the mount request. Successive keyword parameters may 
be entered in any order and must be separated by blanks or 
commas. For a complete description of the effect of each of 
the keyword parameters, see the "Magnetic Tape User's Guide" 
in Volume 4. The tables on the following pages summarize the 
keyword parameters currently available. The default values 
are underlined where appropriate. 


Iteas mounted by the $MOUNT command may be dismounted by the 
SRELEASE command. 


Examples: SMOUNT 
1234 OTP *TAPE* VOL=001236 RING=IN ‘TEST TAPE #1* 
POOL 9TP *POOL* 
SENDFILE 


The labeled maqnetic tape 1234 is mounted on a 9=track 
magnetic tape unit; the volume label of the tape is 
0012348 and the external identification is TAPE TEST #1; 
the tape is mounted with the file protect ring in; the 
tape is assigned a pseudo-device name *TAPE*, A pool 
tape is also mounted on a 9-track tape unit; it is 
assigned the pseudo-device name *POOL*. 


SMOUNT MNET *W* DEST=MS 


A MERIT network connection to Michigan State University 
is mounted and assigned the pseudo-device name *W*. 


232 SOUNT Cowsand 


April 1974 


For_magnetic tapes: 


{BLOCKING | BLK} = {ON | OFF} 


{DSNAME| DSN} =name 


{FORMAT (PMT| RECPM}=fmt[ ([ size ]{ ,lrecl]) } 


LP= {ON | OFF} 


LRECL=n 


MODE=(8001 1600} 


NEWEXP={yymmdd | NONE} 
NEWRPW= (psswrd | NONE} 
NEWWPW={psswrd | NONE} 
OVRIDE=0K 

POSN= {*n*{ *EOT* fname} 
QUIT= {YESI NO} 
REROUN= {YES | NO} 
RETRY=n 

RING={IN( QUT} 


RPW=psswrd 
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Keyword Parameter Summary 


Enables or disables blocking 


Data set name to be used for 
first new file written 


Specifies blocking format and, 
optionally, block size and/or 
logical record length 


Enables or disables label 
processing 


Specifies logical record length 
(1s n S$ 32767) 


Specifies tape mode 


Initializes, changes or deletes 
the expiration date for writing 


Initializes, changes or deletes 
the read password 


Initializes, changes or deletes 
the write password 


Overrides existing expiration 
date for writing 


Positions tape to the nth file, 
end-of=-tape or data set name 


Controls termination of batch 
job if mount fails 


Specifies rerunning of a batch 
job if no drives are available 


Specifies retry count for read 
errors (0 €¢ n € 15) 


Specifies placement of file 
protect ring 


Protects reading tapes with 
RING=0UT 
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{SIZE| BLKSIZ2} =n 


{VOLUME | VOL| LABEL] VOLSER} =nare 


WPW=psswrd 


WRITE (YES ( NQ} 


Por _NEBIT_netvork connections: © 


QUIT= (YES |NO} 
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Specifies maximum block size 
(W8S n $ 32767) 


Volume name of labeled tape 


Protects writing tapes with 
RING=IN 


Specifies placement of file 
protect ring 


Specify connection destination 


Control termination of batch 
job if aount fails. 
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Purpose: 


Prototype: 


Description: 


Examples: 
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NET 


COMMAND DESCRIPTION 


To enter network mode. 
S$NET [ *pdn*] ([network-command... ] 
*pdn* 


"“*pdn** is the pseudoedevice name of a previously 
acquired MERIT network connection. If the pseudo-device 
hame is omitted or invalid, the user is prompted for it. 
If the user previously left network command mode via the 
MTS network command, the previously used connection is 
Maintained unless a new pseudo-device name is specified. 
Network connections are acquired via the SMOUNT command. 


network=command 


"network-command" is an optional network command line to 
be passed to network command mode upon entry. 


See "The MERIT Network User's Guide" in Volume 4 for a 
complete description of how to use network mode with the 
MERIT computer network. 
$NET *8* 

Network mode is entered for the pseudo-device *wW*. 


$NET 


Network mode is entered for the last pseudo-device used 
on a $NET command. 


NET Command 235 


#TS Volume 1: MTS -- The Systen 


April 1974 
NUSBER 
COMMAND DESCRIPTION 
Purpose: To start automatic numbering of input lines being read fron 
*SOURCE* and being written on the currently active file 
(*AFD*). 
Prototype: SNUMBER [par] 


one of the two following parameter sequences may be given: 
{starting-nugber ] {[, Jincrement } 


The starting line number for automatic line numbering is 
given by “starting nuaber", If this is omitted, line 
numbering begins with 1. The starting line number can 
take any one of the three forms: 


line number 
LAST 
LASTtnuasber 


where BLAST is the line number of the last line in the 
currently active file. If the file is empty, the value 
of LAST is zero. 


The line number increment is given by "increment", It 
may be specified in the same manner as the "starting 
nuaber", If "increment" is omitted, line numbers are 
incremented by 1. The parameter "increment" sust be 
separated from "starting nuaber" by a blank or a comma. 
If only “increment" is given, it must be preceded by a 
comma. 


CONTINUE 


The parameter CONTINUE resumes automatic numbering fron 
the point where automatic numbering was when last 
terminated by the SUNNUMBER command. The release or 
change of the currently active file affects automatic 
numbering by causing the numbering to start at line 
number 1 when CONTINUE is specified. If CONTINUE is 
specified and automatic numbering has not been previous- 
ly turned on, the starting line number and the increment 
defaults to 1. 


Description: Provided there is a currently active file, any input line not 


recognized as a command line has a line number automatically 
assigned to it before it is written on the currently active 


236 NONBER Command 


April 1974 


Examples: 


MTS Volume 1: MTS -= The Systen 


file. In the absence of automatic numbering, this line 
number is taken from the first characters of the input line 
if they are valid as a line number. If they are not valid, 
the line is treated as an invalid command. The NUMBER 
command turns on automatic numbering of the input lines being 
read from *SOURCE*. In terminal mode, this number is printed 
at the front of the input line in the form: 


#nuaber 
# 1 
¥ 2 


(This printing of the "#" may be turned off by the $SET 
PFX=OFF command.) The line numbers provided by the automatic 
numbering sequence are taken as the line number for the input 
line; the first characters of the line are treated as an 
integral part of the line. The line number assigned to the 
input line is used for an indexed write operation to the 
currently active file. Therefore, the currently active file 
should be a line file or a device. If the currently active 
file is a sequential file, the command $SET SEQFCHK=OFF must 
be issued first; however, the line number assigned to the 
input line is ignored and the line is written sequentially at 
the end of the file. 


In terminal mode, when automatic numbering is turned on and 
there is an active file, all command lines must begin with a 
$. Consequently the UNNUMBFR command must always be preceded 
by a $. 


SNUMBER 


This turns on automatic numbering with a starting line 
number of 1 and an increment of 1. 


‘$NUM 10,5 


This turns on automatic numbering with a starting line 
number of 10 and an increment of 5. 


SNUM -100 


This turns on automatic numbering with a starting line 
number of -100 and an increment of 1. 
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PZREIL 
COMMAND DESCRIPTION 
Purpose: To allow users to access other user's files. 
Prototype:  $PERATT [filename] [access type] 
filenare 


"filename" is the name of the File to be permitted. If 
“Eilename* is omitted, the user is prompted to enter a 
filenagze and access-type. Filenases and access-types 
should be listed, one set per line, terminated by a nuil 
line or ah end-of-file. 


access-type 
“access type"" is one (or more) of the following: 
ALL All other users are allowed to read the file. 


RUN The file may only be run or loaded. It may not 
be copied or listed. 


PROJNO The file may be read (nsing *COPY) by all other 
_ users having the same project number as the 


owner. 

NONE The owner has unlimited access. All other users 
have no access. 

CNW The file may not be written or emptied. 

RO RO is equivalent to CNW and ALL. 


If no access type is specified, NONE is assumed. 

Description: The above information is for reference only. For a general 
description of the various parameters, see the “Shared Files" 
section of the “Files and Devices" description in this 
volune. 

Examples: SPERMIT X ALL 

All users are given read access to file X. 
SPERMIT Y CNW RUN PRINO 


All users with the same project husber as the owner are 
allowed run only access to file Y. The owner can no 
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longer change the file (although he can 
it). 


SPERMIT X 


All permit access is removed from file ¥. 


still destroy 
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RELEASE 
COMMAND DESCRIPTION 


Purpose: To release the currently active file or device. 
Prototype: SRELEASE [*pan ] 
*pdn* 


“*pdn*" is either *AFD*, the pseado-device name from a 
mount request to SMOUNT, *PRINT*, *PUNCH*® , or *BATCH*, 


Description: If the parargeter is omitted or is *AFD*, the currently active 
file or device is closed and the pseudo-device *AFD* is 
disassociated from the file or device and becomes undefined. 


The RELEASE command is used in this case after all changes to 
a file have been made. It protects the user from accidental- 
ly entering data into the file through the misspelling of a 
command, or in batch mode, through having a program terminate 
abnormally and leaving as yet unread data cards which could 
be mistakenly entered into the active file. 


If the parameter specifies a pseudo-device name for a mounted 
device, that device is dismounted. 


If the parameter specifies *PRINT*, *PUNCH*, or *BATCH*, the 
associated job is released to HASP. This is the same as if 
the command 

SCONTROL *...* RELEASE 


was given. 


Example: SREL 
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RESTART 


COMMAND DESCRIPTION 


To restart (or initiate) execution of a program following 
either initial loading, an interrupt, or a subroutine call to 
ZRROE, MTS or MTSCMD. 


SRESTART [({AT] lccation] [MAP[=mapFDname]] [NOMAP] [XREP] 
(I/OFDnames] (linits] 


The following parameters may be given: 
{ AT] location 


The address at which execution is to begin is specified 
by “location", “location” is a virtual memory location 
given by an optional local relocation factor and a 
displacement in the form 


(RF=(hhhhhh{GRx} ) xxxxxx 


where “hhhhhh® is the hexadeciaal value of a local 
relocation factor or GRx indicates the general register 
whose. contents are to be used as a local relocation 
factor, and "xxxxxx" is the hexadecimal value of a 
displacement. The displacement is added to the current 
value of the relocation factor to provide an absolute 
virtual memory address, If a local relocation factor is 
not specified, the global relocation factor is used. 
The global relocation factor is initially zero, but may 
be changed by the $SET command, Since this value 
replaces the right-hand 32 bits of the PSW, “location" 
specifies the instruction length code, the condition 
code, and the program mask as well as the displacement. 


MAP[ =mapFDname] [NOMAP] [XREF] 


The user can redesignate the destination of future load 
haps with the MAP keyword. This is only useful if- the 
program is loading other modules dynamically by calling 
the subroutines LOAD, LINK, or XCTL. The NOMAP keyword 
can be used to suppress the printing of all future load 
maps. See the RUN command description. 


I/OFDnames 


The user can reassign the logical I/0 units. See the 
FUN command description. 
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FORTRAN users are reminded that MTS logical I/O units 0 
through 19 are not’necessarily the game as the FORTRAN 
logical I/0 units 0 through 19, The FORTRAN 1/70 
routines may default the FORTRAN logical I/0 units 
independently of MTS. Moreover, if this has happened, 
the meaning of these units cannot be reassigned by a 
RESTART command. 


linits 


The user can specify local limits for CPU time, pages 
printed, and cards punched. See the RUN command 
description. If no lisits are specified, no limits are 
enforced. Any limits specified on previous RON or 
RESTART commands are ignored. 


Description: The RESTART command restarts (or initiates) execution of the 
currently loaded program. This may be a program loaded by 
the LOAD command, a program that was interrupted during 
execution by a program or attention interrupt, or a program 
that terminated by a subroutine call to ERROR, MTS or MTSCMD. 


A 32-bit value is computed froa the “location" specification 
and replaces the right-hand 32 bits of the PSW. If “location" 
is omitted, the PSW remains unaltered, and execution begins 
at the entry point for a program loadeq by the LOAD command, 
or the point of interruption for a program that is inter- 
rupted by a progran or attention interrupt; for a progran 
that is interrupted by a call to ERROR, MTS or MISCMD, 
execution restarts at the point following the subroutine call 
as if the subroutine returned to the progran. 


T£ logical I/0 urits have been reassigned, the files and 
devices originally assigned are closed, and the newly 
assigned files and devices are opened. 


Exaaples: SRESTART SPRINT=A 


This restarts the currently loaded progran with SPRINT 
output reassigned to the file A. 


SRE AT RF=520800 28000258 
The program is restarted at location 520A58 with the 
condition code set to 2, fixed point overflow interrup- 


tion enabled, and the other program mask interrupts 
disabled. 
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RUN 


COMMAND DESCRIPTION 


To load and initiate execution of a progran. 


$RUN [objectFDname ] (MAP[=mapFDname]] (NOMAP]} [ XREF] 
{I/vorpnames] [limits] [PAR=parameters] 


The following parameters may be givens: 
objectFDname 


"objectFDnaze" specifies the file(s) or device(s) con- 
taining the program(s) to be loaded. If omitted, the 
program is loaded from *SOURCE*,. 


MAP([=mapFDname] [NOMAP] (XREF] 


The MAP keyword specifies the file or device “mapFDname" 
on which the loader is to write the load map. I£€ the 
MAP keyword parameter is omitted, no load map is 
written, If the MAP keyword is given in the form of 
MAP, "mapFDname" defaults to *SINK*. The NOMAP paramet-_ 
er suppresses the printing of the load map. NOMAP need 
be given only if a previous MAP specification was made. 


The XREF parameter specifies that a cross reference 
listing of external symbols occurring in the loaded 
programs is to be produced in addition to the load aap. 
If XREF is given without the MAP keyword, MAP=*SINK* is 
assumed. If XREF is given with NOMAP, only the cross 
reference is produced. 


I/OFDnames 


The keyword parameters "I/OFDnames" are the assignments 
of logical I/70 units to files or devices for use by the 
loaded program during execution. The logical I/0 unit 
assignments establish the I/0 subroutines which are used 
by the loaded program for the input and output of data. 
Where no specifications are stated, the following 
default assignments occur: 


SCARDS=*SOURCE* 

SPRINT=*SINK* 

SPUNCH=*PUNCH* (batch mode if global card est. >0) 
SERCCM=*MSINK* 

GUSER=*MSOURCE* 
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The logical I/O units 0 through 19 have no default 
specifications. See the section "Files and Devices" in 
this volume and the subroutine descriptions for SCARDS, 
SPRINT, SPUNCH, SERCOM, GUSER, READ and WRITE in Volume 
3 for further details on the use of these subroutines. 


FORTRAN users are reminded that MTS logical I/O units 9 
through 19 are not necessarily the same as the FORTRAN 
logical I/0 units 0 through 19. The FORTRAN I/0 
routines may default the FORTRAN logical I/0 units 
independently of MTS. Moreover, if this has happened, 
the meaning of these units cannot be reassigned by a 
RESTART ccmaand. 


linits 


The keyword parameters "limits" specify local limits for 
CPU time, pages printed and cards punched. These can be 
given in the forn: 


TIME= (t(tS( tM} 
RAGES=p 
CARDS#c 


These local limits can be used in both batch and 
terminal mode and are effective only for the execution 
of the program loaded by the SRUN command. See the 
description of the similar global limits in the SSIGNON 
command description for further details of limit 
specificaticns. 


PAR=paranmeters 


The PAR keyword specifies an arbitrary string of charac 
ters to be passed to the loaded program on initiation of 
execution. This is usually a parameter list for the 
program and its interpretation depends on the loaded 
progras. The PAR keyword aust be the last parameter 
field specified in the command. he parameter list is 
terminated by the end of the command line. 


Description: The RUN command calls upon the dynamic loader to load the 
object program into virtual memory. If there are unresolved 
external syabol references after loading from *objectFDaane", 
loading continues from *LIBRARY (the system library). Only 
those parts of *LIBRARY required to resolve the references 
are loaded. If there are still unresolved external 
references, a fatal loading error exists. In terminal node, 
the loader prompts for more loader input; in batch mode, an 
error comment is produced and the loading terminates immedi- 
ately. The search of the system library may be suppressed by 
the $SET LIBR*0OFF command. If $SET. DEBUG=ON has been 
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specified, SDS processes any symbol table information asso- 
ciated with the loaded progran. 


If there were no fatal loading errors, the comment "EXECUTION 
BEGINS" is printed and control is transferred to the entry 
point of the program by a standard subroutine call (the entry 
point address in Gk15, the return address in GR14, the save 
area location in GR13 and the parameter list location in 
GFT). 


The parameter string (specified by the PAR keyword) is passed 
as follows: GR1 contains the location of a fullword address 
constant which points to a region containing a halfword count 
(halfword aligned) followed ky an EBCDIC character region (of 
byte-length specified by the count) containing the parameter 
string. The leftmost bit of the address constant is 1. 


If files or devices specifed by "IvOFDnames" are non-existent 
or are not available, an error comment is produced and the 
logical I/70 unit referring to the unavailable file or device 
is set up such that the first tine the program being executed 
refers to that logical I/O unit, either the user is given an 
opportunity to change the FDname (in terminal mode) or 
execution is terminated (in batch mode). 


If the program terminates execution by restoring the regis- 
ters and returning to MTS via GR14 or by calling the SYSTEM 
subroutine, the comment "EXECUTION TERMINATED" is printed, 
unless $SET DEBUG=ON has been given. 


All storage, files, and devices used for this RUN command are 
automatically released unless the user has issued the $SET 
UNLOAD=OFF command or execution has not terminated normally 
(for example, the program calls the ERROR subroutine or an 
attention or program interrupt has occurred). 


If storage, files, and devices are not released, the user can 
use the commands SDISPLAY, $ALTER, and $RESTART to debug or 
continue the progran. 


S$RON -LOAD 


This loads and initiates execution of the program in the 
temporary file -LOAD which could, for example, contain 
the object module from a FORTRAN compilation using *FTN. 


$R OBJPROGt+*SSP MAP 5=INPUT 6=OUTPUT 


This loads and initiates execution of the program in 
OBJPROG which presumably contains references to subrou- 
tines in *SSP. A load map is printed on *SINK*, 
Logical I/0 units 5 and 6 are specified for the input 
and output of data to the progran. 
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SRON *WATFOR T=10 


This loads and initiates execution of the Waterloo 


FORTRAN progran. A local time estimate of 10 seconds is 


specified. 


$R *ASMG SCARDS©=SOURCE SPUNCH=OBJPROG .O=*SYSMAC 2=MACROS = 


286 RUN Compent 


‘PARSIBLK=40 ,T, FX, RD 


This loads the 360 assembler *ASNG and initiates execu- 
tion of the assesbler vith source input from the file 
SOURCE -and object module output to the file OBJPROG. 
The macro libraries *SYSHAC and MACROS are attached to 
logical “IvO units 0 and 2. ‘Tee parameter string in ‘the 
PAR field is passed to the asseabler ‘by the RUN command. 
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SDS 


COMMAND DESCRIPTION 


To enter or return to debug mode. 
SSDS [ debug-conmand ] 
Control is transferred to debug command mode. In debug mode, 
the user has the facilities of SDS at his disposal. See the 
section "Debug Mode" for a description of the symbolic 
debugging systen. 
If a debug command is specified with the SDS command, that 
debug command is executed, and control is returned immediate- 
ly to MTS command mode. 
$SDS 

Control is transferred to debug mode. 


SSDS SET ERRORDUMP=ON 


The automatic errordumping option of SDS is enabled; 
control is returned to MTS command mode. 
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SET 
COMMAND DESCRIPTION 


fo set various global switches and paraneters. 
SSET keyword ... 


Any nusber of the following keyword parameters may be given 
in a single $SET command. The keyword parameters should be 
separated by blanks; there must be no blanks within any 
keyword paraseter. 


All of the values set by these keywords may be interrogated 
by programs using the GUINFO subroutine and may be changed by 
progranks using the CUINFO subroutine. See the subroutine 
description for GUINFO and CUINFO in Voluae 3 for details. 


AFDECHO= (ON( OFF} Default: OFF 


If the AFDECHO keyword is ON, all lines written to the 
active file in command saode are echoed to *SINK* and 
*MSINK*. .-Each line echoed is preceded by its line 
nuaber in the active file. 


CASE= (UC| LC | BX (| MIXED) Default: LC 


The CASE keyword specifies global uppercase (UC) or 
lowercase (LC) conversion. If UC is specified, all data 
lines read by the MTS monitor have lowercase letters 
converted to uppercase letters. If LC is specified, the 
data lines are not converted. 4X and MIXED are equiva- 
lent to LC. 


CHDSKP= (ON | OFF} Default: OFF 


Normally, in printed output from a batch run, a page= 
skip is produced automatically following any commands 
that may generate printed output (LIST, COPY, RUN, and 
so on). If the CSDSKP keyword is OFF, only a _ triple- 
space is produced, if CHDSKP is ON, the page-skip is 
produced. 


CONTCHAR=character Default: = 


The CONTCHAR keyword specifies a single character to be 
used as an indicator for continuing an ATS command line 
on another input line. The continuation character aust 
be the last character of the line to be continued. 
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COST= {ON [OFF} Default: OFF 


If the COST keyword is ON, the cost since the last cost 
was printed (not necessarily the cost of the last 
command) and the total current cost of the session is 
printed; these costs then continue to be printed after 
every command. These costs are approximate and subject 
to roundoff; items which are not immediately charged for 
such as tape drive time are not included until the 
actual charge is made. If cost is off, these costs are 
not printed. This keyword is the same as the $ keyword 
described below. 


CREAFD= {ON| OFF} Default: ON 


If the CREAFD keyword is ON, a successful $SCREATE 
command causes the created file to become the currently 
active. file. If CREAFD is OFF, the created file is not 
made the currently active file. 


DEBUG= {ON]{ OFF} Default: OFF 


If DEBUG is ON, all programs loaded are processed by SDS 
for any symbol table information associated with then. 
This allews debug mode commands to refer to symbols in 
programs compiled with the TEST option. Also, all 
programs run in execution mode are monitored by SDS and 
any errors produce debug mode error comments. 


DEVCHAR=character Default: > 


The DEVCHAR keyword specifies a single character to be 
used to indicate that a following FDname is a device, 
not a file. 


- ECHO= {ON(OFF} Default: ON 


If the ECHO keyword is ON, STS command lines are echoed 
on the *SINK* or *MSINK* devices (or files) if these 
devices (or files) are different from the *SOURCE* 
device (or file). If ECHO is OFF, echoing does not 
occur. 


EDITAFD= {ON | OFF} Default: OFF 


If the EDITAFD keyword is ON, the $EDIT command causes 
the file to be edited to become the currently active 
file. If EDITAFD is OFF, the file to be edited is not 
made the currently active file. This keyword may also 
have other effects on the $EDIT command. See the S$EDIT 
command in this volume for details. 


SET Command 249 


MTS Volume 1: STS -- The Systen 


April 1974 


ENDPILE= (ON{ OFF | NEVER} Default: OFF 


If the ENDFILE keyword is ON, a SENDFILE line is 
recognized as an end-of-file whenever it is read; if 
ENDFILE is OFF, a S$ENDFILE line is recognized as an 
end-of-file only when read from *SOURCE* or *MSOURCE*; 
if ENDFILE is NEVER, a SENDFILE is never recognized as 
end-of-file. 


-ERRORDUMSP=(O8 (OF F{ FULL} Default: OFF 


If the BRRFOFRDUMP keyword is ON and execution terminates 
abnormally in batch node, a storage dump of the user's 
loaded program is given; if ERRORDUMP is FULL, the 
storage dump includes any library subroutines loaded; if 
ERRORDUSP is OFF, no dump is given. ON is the same as 
FULL unless “S$SET SYMTAB=ON" was specified before the 
program was loaded. The ERRORDUMP keyword has no effect 
in terainal aode. 


FILECHAR#=character Default: # 


The FILECHAR keyword specifies a single character to be 
used to indicate that a following FDname is a file, not 
a device. 


ICc= {ON | OFF} Default; ON 


If the IC keyword is ON, the line "$CONTINUE WITH" 
specifies implicit concatenation; if IC is OFF, this 
line is treated as a data line. The IC keyword can be 
overridden by the @IC modifier on I/0 operations. (See 
the appendix "I70 Modifiers" to the section "Files and 
Devices" in this volune.) 


LIBR= {OW (OF F} Default: ON 


If the LIBR keyword is ON, the file *LIBRARY and 
LCSYMBOL (the lowecore syabol directory) are searched 
for unresolved external sysbols after a program is 
loaded; if LIBR is OFF, this search is not made. 


LIBSRCH= (OF F{ FDnare} Default: OFF 


The LIBSRCH keyword indicates what (if any) public or 
private libraries are to be searched if there are 
unresolved ‘symbols in a loaded program. This keyword 
interacts with the LIBR keyword. If LIBR is OFF, then 
the LIBSRCH keyword is ignored. If LIBR is ON, but 
‘LIBSRCH is OFF, then only *LIBRARY (the systea library) 
and LCSYMBOL (the low-core syabol directory) is searched 
(if the *LIBRARY keyword is ON). If LIBR is ON and 
LIBSRCH is not OFF, then LIBSRCH specifies a library or 
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concatenation of libraries to be searched. The 
libraries are searched in the order specified in the 
keyword. After these libraries are searched, *LIBRARY 
and LCSYMBOL are searched if there are still any 
unresolved symbols (if the *LIBRARY keyword is ON). 


LNS=character Default: , 


The LNS keyword specifies a single character to be used 
as a line number separator. The line number separator 
is used to terminate the line nuaber for the input line 
read in MTS command mode and indicates that the remain- 
ing characters are a part of the data line itself. This 
is used to distinguish a line beginning with numeric 
information from the line number (for example, 174, 
112233445566 has a line number of 174 and a data line of 
112233445566). 


PFY= {ON| OF F} Default: ON 


If the PFX keyword is ON, the terminal prefix character 
is printed at the front of each input or output line at 
the user's terminal, or if automatic numbering is on 
(due to the NUMBER command) and there is an active file, 
the line number that is assigned is printed at the front 
of each input line at the user's terminal: if PFX is 
OFF, the printing of the prefix character or line nuaber 
is suppressed. The terminal prefix character is used to 
determine which programs are communicating with the 
user. The prefix character is not printed in batch 
mode. 


PW=characters 


The PW keyword specifies a sequence of one to six 
characters (none of which are blank) to be used as the 
user's password. The user's password must be correctly 
given before the user is allowed to sign on. 


RF= {hhhhhh {GRx} Default: RF=000000 


The RF keyword sets a global relocation factor which is 
used in the $DISPLAY and SRESTART commands. "“hhhhhh* is 
a hexadecimal constant to be used as the global reloca= 
tion factor or GRx specifies a register whose contents 
are to be used as the relocation factor. The relocation 
factor is set to zero initially. If GRx is specified, 
the current contents of that register at the time of the 
SET comaand is used as the relocation factor. 
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SCRFCHAR=character | Default: <- 


The SCRFCHAR keyword specifies a single character to be 
used to indicate that a following FDname is a temporary 
file, not a permanent file. 


SEQ FCHK= (ON OFF} Default: ON 


Normally an attempt to do an indexed operation on a 
sequential file or an attempt to do a_ sequential 
operation starting at other than line 1 on a sequential 
file causes an error condition and an error sessage to 
be generated. If SEQFCHK is OFF, the message is not 
issued and the operation is performed as if not indexed. 


SHFSEP=character Default: : 


The SHFSEP keyword specifies a single character to 
separate the signon ID from the file name when referring 
to a shared file (for example, TAGA:DATAFILE). 


SIGFILE= {OFF | FDnane} Default: OFF 


The SIGFILE keyword indicates which file (if any) is the 
special SIGNON file used as an implicit S$SOURCE file 
after the user signs on. If SIGFIL,E is set to CFF, the 
file or device still exists, but is ‘not used as a SIGNON 
file. The setting of SIGFILE affects subsequent 
signons. 


SIGFILEATT N= {ON { OFF} Default: ON 


Tf the SIGPILEATTN keyword is ON, an attention interrupt 
during the ‘last sign-on" message or while the SIGNON 
file is being processed, interrupts the processing and 
resets SOURCE to MSOURCE. If SIGFILEATTN is OFF, 
attention interrupts are stacked, but are not taken 
during the SIGNON file processing (except if the SIGNON 
file rans a program which calls the subroutine ATINTRP, 
the attention is taken at that point and given to the 
program). The setting of SIGFILEATIN affects subsequent 
signons. 


SYMTAB= (ON | OFF} Default: ON 
If the SYMTAB keyword is ON, the loader symbol table is 
retained whenever a program has been loaded. This 
allows external symbols used in a program to be used by 
MTS and other user prograns. If SYMTAB is OFF, the 
loader symbol table is not retained. 


TDR®= [ON] OFF} Default: OFF 
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If the TDR keyword is ON, the CPU time (in seconds) and 
the number of drum reads which have occurred since the 
last MTS command was terminated, is printed on *SINK*, 
This allows a user to easily obtain a timing estimate 
for the execution of a progran. 


TERSE={ON(OFF} Default: OF? 


If the TERSE keyword is ON, many informational and error 
messages from MTS are suppressed or abbreviated. If 
TERSE is OFF, all messages are given in full. 


TRI M= {ON | OFF} Default: ON 


If the TRIM keyword is ON, lines read or written to 
files are trimmed (trailing blanks are removed). If 
TRIM is OFF, the lines are not trimmed. The TRIM 
keyword can be overridden by the @TRIM modifier on I/0 
operations. (See the appendix "I/O Modifiers" to the 
section "Files and Devices" in this volune.) 


UNLOAD= (ON{ OFF} Default: ON 


If the UNLOAD keyword is ON, all storage, files and 
devices from a previous LOAD or RUN command are automat- 
ically released at the end of normal execution; if 
UNLOAD is OFF, they must be released using the UNLOAD 
command, 


*LIBRARY= [ON OFF} Default: ON 


Tf the *LIBRARY keyword is ON, *LIBRARY is searched for 
any unresolved external symbols after a program is 
loaded (if the LIBR keyword is ON). If *LIBRARY is OFF 
(or if LIBR is OFF), this search is not made. 


$= (ON[ OFF} Default: OFF 


If the $ keyword is ON, the cost since the last cost was 
printed (not necessarily the cost of the last command) 
and the total current cost of the session is printed; 
these costs then continue to be printed after every 
command, These costs are approximate and subject to 
roundoff; items which are not immediately charged for 
such as tape drive time are not included until the 
actual charge is made. If $ is OFF, these costs are not 
printed. This keyword is the same as the cost keyword 
described above. 
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IC@=OFP ENDFILE=NEVER 


This forces the lines "SCONTINUE WITH" and "SENDFILE" to 
be interpreted as data lines, not as iaplicit concatena- 
tion indicators or as end*of«file. 


ECHO=OFF 
PWeAJAZ ECHO=ON 


This batch exaaple sets the aser's password to AJAX. 
The echoing of ATS command lines is turned OFF so that 
the password is not echoed on the user's output. 


SCREATY <SIGFILE> 


$GET 


<SIGPILE> 


1SSSET COST#ON ERRORDUMP=ON 


SSET 
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SIGPILE=<SIGFILE> 


This example creates a file <SIGFILE> to be used as a 
SIGNON file. This SIGNON file contains a SET coasand to 
set the COST and EBRRORDUMP options to ON. Each time the 
user signs on, this file is invoked causing the speci- 
fied options to be set. 
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SIGNOFF 
COMMAND DESCRIPTION 


To notify the system of a user's departure. 
$SIGNOFF ( SHORT] $} 
The only legal parameters are: SHORT or §$ 


An abbreviated form of the sign off statistics is 
produced when the SHORT keyword is given. If $ is 
specified, only the time and date of the user's signoff, 
the approximate cost of the session, and the user's 
remaining balance of funds is printed. 


The user is signed off the system. All storage acquired and 
devices attached are released, and all files are closed 
(temporary files are destroyed). A summary of the job 
statistics is printed. These statistics include all of the 
non-zero entries from the following items: 


User SIGNON ID (batch only) 

Project number (batch only) 

Time of sign-on (batch only) 

Tine of sign-off 

Elapsed time in ainutes 

CPU time used in seconds 

CPU storage virtual menory integral in page-minutes 
Wait-state virtual saemory integral in page-hours 
Number of cards read 

Number of lines printed 

Number of pages printed 

Number of cards punched 

Number of tape mounts 

Tape drive time used in minutes 

MERIT network time 

Nuaber of drum reads 

Approximate total cost of the job 

Charge for plotting tine 

Charge for disk space used since last sign-off 
Remaining balance of funds for the ID 

Time of the previous sign-on (batch only) 


If the abbreviation $SIG is used, its meaning is taken in 
context: if the user is not signed on, $SIG means S$SIGNON; 
if the user is signed on, $SIG means SSIGNOFF. 


SSIGNOFF 
SsIc $ 
$SIG S 
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SIGNON 


COMMAND DESCRIPTION 


Purpose: To identify a user to the systen, 
Prototype: SSIGNON ccid [keywords] {'d name* } 


Only the "ccid" parameter giving the user's signon identifi- 
cation number is required. The other legal keyword parame- 
ters that may be given are: 


PW=password 


The PW keyword specifies the user's password. This 
keyword may be used in both batch and terminal node; 
however, it is recoumended that batch users do not use 
this keyword, but supply the password (without PW=) on 
the card following the $SIGNON command. In this way, 
the password does not appear on the user's printed 
output. 


The following keywords are relevant in batch mode only. They 
are useful for placing global constraints on the user's job. 


TIME=(t (tSitm} Default: 30S 


The TIME keyword gives a number "t" specifying the 
global CPU time limit for the job. If given in the fora 
of the number "t" or "tS", the time liait is in seconds; 
if given in the form "tm", the time limit is in minutes. 
If the TIME keyword is not specified, a default tise 
limit of 30 seconds is enforced. 


PAGES=p ° Default: 50 


The PAGES keyword gives a number "p* specifying the 
global printed page limit for a single copy of the job. 
If the PAGES keyword is not specified, a default page 
limit of 50 pages is enforced. The maximum value that 
can be specified is 99999 pages. 


CARDS=c Default: 0 


The CARDS keyword gives a number "c" specifying the 
global punched card limit for the job. If the CARDS 
keyword is not specified, a default card limit of 0 is 
enforced. The maximum value that can be specified is 
99999 cards. 
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COPIES=n Default: 1 


The COPIES keyword gives a number "n" specifying the 
number of printed copies of the output to be produced. 
If the COPI#S keyword is not specified, one copy of the 
output is printed. 


PRINT= {QN{ TN} Default: any standard train 


The PRINT keyword specifies the type of character set to 
be used for printing the job. This may be either the ON 
or TN character set. The normal character set is QN. 
The TN character set contains a larger set of characters 
(including lower-case alphabetics) and is corresponding= 
ly slower in printing output. For a description of the 
character sets, see the "Print Character Sets" section 
in Volume 5 of the MTS manuals. 


ROUTE=locn Default: location where job 
PROUTE=locn was submitted. 
CROUTE=locn 


These three keywords specify the destination for printed 
and punched output. "locn™" is a four character code 
specifying the location at which the job's output is to 
be printed and/or punched. The ROUTE keyword sends all 
output to "locn", while the PROUTE and CROUTE keywords 
send the printed and punched output, respectively. 
Currently, CNTR is the code for the Computing and Data 
Processing Center and SCIL is the code for the Science 
Library basement. If any station specified does not 
have a card punch, the punched output is re-routed to 
CNTR. The default for all *BATCH*, *PRINT*, and *PUNCH* 
jobs is CNTR. 


td name! 


The 


This comment field should contain a delivery code "a" 
(see Appendix B of the Facilities and Services of WSU 
Computing and Data Processing Center for a list of valid 
delivery codes}, and user identification "name" which 
may actually be the user's name, course and section 
number, etc. If the output is to be retained at the 
CDPC Control Desk rather than delivered, the first 
character of the comment field must be a blank. The 
comment must be the last item of the $SIGNON command and 
must be enclosed in single quote marks. 


SSIGNON command identifies the user to the system (that 


is, signs him on), and in the case of batch jobs, establishes 
certain constraints for the job. The SSIGNON command must be 
the first command of the user's job. 


SIGNON Command 257 


HTS Volame 1: MTS -- The Systen 


Examples: 


April 1974 


If the user has not specified a password on the SSIGNON 
command, the system prompts hia for the password at a 
terminal. For a batch job, the system expects to find the 
password starting in coluan 1 on the next card following the 
SSIGNON card. 


A user may not be signed on more than once at any one time 
for any given "ccid", 


If the abbreviation S$SIG is used, its meaning is taken in 
context; if the user is not signed on, $SIG means SSIGNON; 
if the user is signed on, $SIG means S$SIGNOFF. 


SSIGNON 2AGA * JOHN Q. DOE® 


The user with ID 2AGA is signed on to the system. All 
global limits and output specifications have default 
values. 


$SIG 2AGA T=1M P=100 C=50 'P JOHN Q. DOE* 


The aser with ID 2AGA is signed on to the system. The 
global limits are 1 ainute of CPU time, 100 pages of 
printed output, and 50 punched cards. The deck and 
output is delivered to the Physics Departaent distribu- 
tion center. 


S$SIG 2AGA T*20 COPIES=2 PRINT=TN * JOHN Q. DOES 


The global time limit specifed is 20 seconds. Two 
copies of the printed output are produced using the MTN 
character set. 


$SIG 2AGA C=1000 PROUTE=SCIL *W JOHN Q. DOE® 


A batch job submitted elsewhere is printed at SCIL 
(Science Library). The punched output is punched at 
CNTR and is delivered to location W (Science Library) 
along with the input deck. 
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SINK 
COMMAND DESCRIPTION 


To change the destination or "sink" for normal output lines. 
SSINK [(FDname{ PREVIOUS} | 
One of the two following parameters sust be given: 

FDnanme 


The name of the file or device that is to become the 
current sink of output lines. 


PREVIOUS 


The PREVIOUS parameter specifies that the previous sink 
is to be restored as the current sink. To output toa 
file by the name PREVIOUS, the file character # must 
precede the file name. 


When the SSINK command is given, the pseudo-device *SINK* is 
reassigned to the file or device specified. This causes 
output which defaults to *SINK* to be sent to that file or 
device, The master sink *MSINK* remains as the terminal in 
terminal mode or the printer in batch node. Initially *SINK* 
is assigned to the same device as *MSINK*. 


Error messages requiring user interaction are directed to 
*MSINK* (terminal mode only). 


An attention interrupt causes *SINK* to revert to *MSINK*, 
A one level pushdown list of sink devices is maintained. The 
PREVIOUS parameter uses this pushdown list to restore the 
previcus sink device. 
SSINK A 

The file A becomes the current sink for output lines. 


SSINK PREVIOUS 


The previous file or device used as the sink becomes the 
current sink for output lines. 
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SOURCE 
COMMAND DESCRIPTION 


Purpose: To change the source of input lines. 

Protot ype: SSQURCE {FDnane| PREVIOUS} 
One of the two following parameters must be given: 
FDnarme 


The name of the file or device that is to become the 
current source of input lines. 


PREVIOUS 


The PREVIOUS parameter specifies that the previous 
source is to be restored as the current source. To 
source to a file by the name PREVIOUS, the file 
character # must precede the file name. 


Description: When the $SOURCE command is given, the pseudowdevice *SOURCE* 
is reassigned to the file or device specified. This causes 
the next igput line to be taken from that file or device. 
Input that defaults to *SOURCE* is read from that file or 
device. The master source *MSOURCE* remains as the terminal 
in conversational mode or the card reader in batch mode. 
Initially *SOURCE* is assigned to the same device as 
*MSOURCE*?. 


Responses to error messages requiring user interaction are 
read from *HSOORCE*, 


An attention interrupt, or an end-of-file condition on 
*SOURCE* when trying to read an MTS command, causes *SOURCE* 
to revert to *MSOURCE*. 
A one level pushdown list of source devices is saintained. 
The PREVIOUS parameter uses this pushdown list to restore the 
previous source device. 

Example: SSOURCE A 


The file A becomes the current source for input lines. 
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COMMAND DESCFIPTION 
Purpose: To restart (or initiate) execution of a program following 
either initial loading, an interrupt, or a subroutine call to 
ERROR, MTS, or MTSCMD. 
Prototype: $START ([[AT] LOCH] { MAP[ =mapPDnane }] (NOMAP (XREP] 


{I/OFDnames] [ limits] 


This command is identical to the SRESTART command. 
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UNLOAD 
COMMAND DESCRIPTION 


To unload the currently loaded program in virtual memory. 
SUNLOAD (CLS=xxx ] | 


The S$UNLOAD command unloads the current prograa which had 
previously been loaded by a SLOAD command or a SRUN command 
if execution did not terminate norreally. (Normal termination 
is by the program returning to the system with a return code 
of zero or a subroutine call to SYSTEM.) All storage 
allocated to the program is released, and all files and 
devices opened at execution time are closed. 


The parameter "CLS=xxx" releases all space associated with 
the command language subsysterm “xxx", This should be used 
only if the CLS is not working properly. 


SUNLOAD 
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NUMBER 
COMBAND DESCRIPTION 


To turn off automatic nuabering of input lines from *SOURCE*. 


SUNNUMBER 


Automatic number of input lines being read from *SOURCE* is 
turned off. Any input line, not recognized as a command line 


or 


a data line (starts with a valid line nusber), is treated 


as an invalid command. 


fnuaber 

# 1_this 

# 2is data 

# 3_Sunnuaber 


Automatic line numbering was started with beginning line 
number of 1 and an increment of 1. Three lines later 
automatic numbering was suspended with the SUNNUMBER 
command. Automatic numbering may be resumed with a 
starting line number of 3 and an increment of 1 by 
issuing the NUMBER CONTINUE command. 
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EDIT MODE 


The MTS context editor program is used for the editing of MTS line files. 
The editor is invoked by the command 


SEDIT filename 


where "filename" is the name of the MTS line file to be edited. (See the 
MTS $EDIT command description in this volume for details.) Commands to the 
editor are read from the pseudo-device *SOURCE* and editor output messages, 
diagnostics, and verification comments are written on *SINK*. After the 
file "filename" has been obtained, the editor responds with a colon ";" at 
which point it is ready to accept edit commands. 


Files 


References to line. numbers within a file by the edit commands and 
references to line nuabers within a file by MTS file naming conventions 
are the same. Hence limits of line numbers and file sizes applicable 
to MTS conventions apply to the editor as well. The specification of 
line number ranges and explicit concatenation for the file are ignored 
by the editor. The file is read with the I/O modifiers implicit 
concatenation off and trimming off (-IC and -+TRIM). The file is 
written with triaming off. 


ka 


files. Text editing of 


The editor program works only with MT 
s line numbers is not 


sequential files and sequential file 
supported by this progran, 


Column Ranges 


Various edit commands which perform some action on lines of the 
files being edited act only within a specified “column range", an 
interval of each line. Two column pointers are associated with the 
column range which is defined as extending from the character pointed 
to by the first column pointer through that pointed to by the second 
column pointer. 


The COLUMN command is provided to allow the user to specify the 
values of both the first and second column pointers. Because of the 
restriction on line sizes in MTS files (255 characters), the column 
pointers are restricted to a range of values from 1 to 255. The first 
column pointer must be less than or equal to the value of the second 
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pointer. The values assigned to the column range pointers place no 
additional restriction on the size of the individual lines within the 
files. 


Regions 


Some of the edit commands may perform their function on sore than a 
single line of the file. When this is the case, the range of file 
lines upon which they operate may be specified by a name rather than 
always by the first and last line numbers. This name is specified by 


/XXXEXX 


where “xxxxx" is from 0 to 7 none-blank characters, and is known as a 
line region nane. 


Edit commands for which a line region specification is walid require 
the name of the region as a parameter. Unlike the coluan range for 
which there is only one specification, several line region names may be 
defined. The REGION command is provided for defining and establishing 
the values of line regions. The interval over which the line region 
applies is defined as the line pointed to by the first value through 
the line pointed to by the second value. The values of the line 
pointers in a line region specification are any yalid MTS line numbers, 
that is, any "n" where 


~99999.999 <n < 99999.999 


The restriction that the numerical value of the first pointer aust 
be less than or equal to that of the second pointer applies. The value 
assigned to a region name places no additional restriction on the 
extent of MTS line nusbers. 


The editor has one predefined region name */FILE" which is used to 
refer to the entire file. 


Switches 
Two general classes of switches are defined: 


(1) Global switches which are set by default or by the user with 
the SET command and which govern the action taken by commands 
and error conditions which occur during execution. These are 
defined and explained under the SET edit command description 
below. 


(2) ec switches which are set as a result of some action 


occurring during execution. These are explained under the 
Yee procedure section below. 
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Checkpoint/fRestore Facility 


This facility allows the user to preserve the state of his file at 
any time. This is done by using the CHECKPOINT command to initiate a 
checkpoint buffer; then any commands which are executed that cause 
changes to the text of the file are recorded in the checkpoint buffer 
along with sufficient information to restore the changed lines to their 
state before the CHECKPOINT command was issued. The checkpointing 
feature may be suppressed for the duration of a command by the aONCH 
modifier. 


The user may restore at any time all or portions of his file to the 
state it was in at the time he used the CHECKPOINT command by using the 
RESTORE command. The RESTORE command may be used any number of tines, 
but it always restores the file to the state in which it was last 
checkpointed. 


The state in which the file is to be checkpointed can only be 
changed by the use of the CHECKPOINT command which reinitiates the 
checkpoint buffer. 


After initiating checkpointing with the CHECKPOINT command, an 
alternate mode of operation is to set the checkpoint switch off using 
the SET command; then, only those commands appended with a @CH modifier 
are checkpointed. 


The editor works with only one copy of the file being edited and 
changes are made as they are entered. This is in contrast with editors 
run on other systems which work with two copies of the file and only 
replace the original with the edited version when requested. 


Attention Interrupts 


Issuing one attention interrupt causes the current command to be 
terminated immediately and the editor to return to edit command mode. 
A second attention interrupt without an intervening command causes the 
editor to return to MTS by calling the subroutine MTS. The editor may 
then be reentered by issuing the EDIT command. 


Xec Procedures 
An Xec is a sequence of commands stored as a named program which may 
be executed under the control of a count parameter (specifying how many 
times the sequence of commands is to be executed), the GOTO command, or 


a combination of these. 


The XEC command is used to name a new Xec and to enter the commands 
to be stored. If the user already has an Xec named $name, the message 


ALREADY DEFINED = ENTER "Y" TO REPLACE, "N" TO RETAIN 
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is typed and appropriate action is taken depending upon the reply. 
Otherwise, the user is prompted with a "?" to enter the command lines. 
to comprise the Xec. Command lines consist of an optional label field 
followed by a command. The label field consists of 1 through 8 
non-blank characters inmediately followed by a colon ("3"). Because of 
the format of the label field, 


REP: PRI /A: 


is a labelled command to print the region named /A:, while 
REP <:PRI /A: 


is an unlabelled REPLACE command. Each command is checked for 
syntactic correctness as it is entered. If a command is found to 
contain a syntactic error, the appropriate error message is printed 
followed by | 


ENTER NEW COMMAND OR ":* TO RETAIN 


and the command is either discarded or retained accordingly. The 
ability to retain commands found to contain syntactic errors is 
prowided so that one can, for example, refer to a region name in 
defining an Xec before defining the region name. In any case, if there 
remain syntactic errors when the Xec is executed, they are caught then. 
Entering of commands is terminated by entering either the pseudo- 
command END, a null line, or an end-of-file. 


Three Xec switch values are defined. Two of these are SUCCESS, 
abbreviated S, and PAILURE, abbreviated F. They are complementary. 
They refer to the success or failure of a command which does some 
operation involving a form of search. Success implies that the command 
was successful at least once within its specified line region. Failure 
implies that it exceeded its line region or encountered an end-of-file 
before fulfilling its function. The third form of ‘Yec switch is 
ENDOFFILE, abbreviated EOF or E. This value is either ON or OFF. It 
is ON if an end-of-file occurs during a read or write operation. It is 
OFP if the read or write operation was completed without an end-of- 
file. The Xec switch value may be tested by the GOTO command. 


COMMAND NASES 


As in the MTS command language, each command is recognized by its sinimur 
distinguishable abbreviation, usually one or two letters. A few commands 
begin with non-alphabetic characters and are recognized by the presence of 
these characters. The command names and their abbreviations are as follows: 
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ALTER A 
BLANK B 
CHANGE : Cc 
CHECKPOINT CHE 
COLUMN coL 
COPY co 
DELETE D 
DOCUMENT DO 
EDIT ED 
EXPLAIN E 
GOTO 

INSERT I 
LINE L 
MATCH M 
MTS MT 
OVERLAY 0 
PRINT P 
REGION REG 
RENUMBER REN 
REPLACE R 
RESTORE RES 
SCAN BS) 
SET SE 
SHIFT SH 
STOP st 
XEC x 
+n n 
-n -n 
$name $name 
/nane /nane 


where "n™ is an integer and "name" is a sequence of 0 through 7 non=blank 
characters. 


There are four general classes of commands: 


(1) those starting with an alphabetic keyword, 
(2) two-commands which are a signed integer, 
(3) those prefixed by a "$", and 

(4) those prefixed by a "/", 


All commands starting with an alphabetic keyword require parameters. In 
many cases if the command is issued without parameters, one or more of 
several default values are assigned to the missing parameters. Many of 
these commands may have modifiers appended to the keyword portion. These 
modifiers are fully described below along with all forms of parameters. 


The two commands consisting of signed integers are used to control the 
value of the current line number. 


The commands which are names prefixed by a "$" are lists of Xec commands 
prepared by the user. They are executed upon the use of their name, which 
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has been previously assigned to them. The name is defined by the user along 
with the list of commands to be used in conjunction with it. 


The prefix "“/" followed by a name causes the line number values of the 
line region represented by that name to be printed provided that such a name 
has been previously defined by the user. 


CONSAND MODIFIERS 


Command Modifiers are composed of an at-sign "@" followed by one to three 
characters. Each modifier aust be appended to the command which it nodifies 
without intervening blanks. More than one such modifier may be appended to 
a command name. For exaaple, 


PRINT@NL@X 100 200 
causes lines 100 thru 200 to be printed in hexadecimal without line numbers. 
Two classes of modifiers are defined: 
(1) Modifiers which everride permanent switch assignments for the 


duration of the coagmand to which they are appended. See the SET 
edit command for an explanation of these switch settings. 


@CH Turn the checkpoint switch on for this command. 
ance Tura the checkpoint switch off for this command. 
aL Turn line-number prefixing on for this command. 
aNnL Turn Line-number prefixing off for this command. 
av Turn verification on for this command. 

anv Turn verification off for this command. 

ax Turn hexadecimal conversion on for this command. 
anx furn hexadecimal conversion off for this command. 


(2) Modifiers which control the action performed by the command. 


aa Apply the given command throughout the given line 
range, rather than only once. 


aPc When using the SCAN and ALTER (CHANGE) commands, 


the ccluan number of the coluan where the string 
found or altered begins is printed. 
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COMMAND PARAMETERS 
Strings 


Line 


A string is a sequence of characters delimited at either end by a 
current delimiter character which may be any one of the following 
characters: 


'™e¢c>(), 2? ts RFit r_f €a 


The first character from this set encountered when scanning for a 
string is taken as the current delimiter character for that string. [If 
a command requires a pair of strings, they must be presented as the 
delimiter, followed by the first sequence of characters, followed by 
the delimiter, followed by the second sequence of characters, followed 
by a third delimiter. If hexadeciaal conversion is on, the character 
string is inspected, and, if it is found to contain only legal 
hexadecimal characters, it is converted to internal character forn. 


Examples: 
The character string: "STRING! 
The null string: an 
The hexadecimal string: #E1TE2D9ICIDSCT# 
A pair of strings: *ABC'DEF'® 


If the final delimiter is omitted when entering a string or pair of 
strings, the editor types 


: PINAL DELIMITER? ¢: 
and waits for an answer to be typed after the second colon. If the 
correct final delimiter is typed followed by ending the line, the 
string or strings are accepted; otherwise, the command is cancelled. 


Numbers 


A file editor line number may be any legal MTS line number or one of 


* The current line 
*F The first line of the file 
*L The last line of the file 


The file editor maintains a current line pointer which is initially 
set to the first line of the file and is nodified by the LINE, MATCH, 
SCAN, n, +n, and -n comagands. 
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Counts 


A count parameter is an integer or (in soae commands) a keyword 
| expression of the fornr 


couUNT=integer 
or 


Czinteger 


Region Names 


2 A region nase is a slash "/" followed by 0 through 7 non~blank 
: characters. Region names are defined by the REGION command and denote 
line nuaber ranges in a file. There is one predefined region, nanely 
"/FILE" which is equatad to the range -99999.999 through 99999.999, 
that is, all of the maTS file. 


Xec Nares 


An Xec name is a dollar sign "$" followed by 0 through . 7 none-blank 
characters. Xec names are defined by the XEC command and denote series 
of stored commands which may be executed as stored progranas. 


Keyword Paraaeters 
A keyword paraseter is either a literal series of characters or a 
| literal series of characters followed by an equal sign "=" followed by 
a value field. 
Exasples: 
COLUMNS 


| REGIONS 
ECHO=ON 


EDIT COMMAND DEFINITIONS 


In the following command descriptions, the syarbol “lpar* is used to 
denote any of the following coabinations of parameters: 


/nane the line range assigned to the region name 


linenusaber the given line nusber 
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linenuaber1 1 


linenumber CO 
COUNT=integer 


(nothing) 


The following 
commands: 


lower case <= 
upper case =< 


brackets (Jj - 
braces {} - 


underlining < 


The following 
command language. 
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inenuaber2 the given range of line nutabers 


UNT=integer “integer” lines beginning with the given line 
Number (COUNT may be abbreviated by C) 


"integer" lines beginning with the current 
line 


the current line, except in the SCAN and MATCH 
ccmmands, for which the default line nusber 
range is the current line through the last 
line of the file 


notation conventions are used in the prototypes of the 


represents a generic type which is to be replaced by an 
item supplied by the user. 

indicates material to be repeated verbatim in the comaand. 
indicate that saterial within the brackets is optional. 
indicate that the material within the braces represents 
choices, from which exactly one must be selected. The 
choices are separated by vertical bars. ; 

indicates the minimum abbreviated form of the command or 
parameter. Longer abbreviations are acceptable. 


pages give a complete summary of the commands in the edit 
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Summary of Edit Comsand Prototypes 


Commands 


ALTER 
BLANK 
CHANGE 


CHECKPOINT 


COLUMN 
COPY 
DELETE 
DOCUMENT 
EDIT 


az 
QVERLAY 
PRINT 
REGION 
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lpar (‘'stri'str2' ] 
lpar ('str‘ 

lpar [ 'str1‘str2*] 
(OFF ] 

{a (nj) 

lpar [TO ({linenuaber }] 
lpar 

lpar 

filenane 

{ {coamand{ ERROR} j 
label ({ON] condition] 
{ linenusber }{ ‘str' ] 
linenusber 

lpar [‘*str* J 

( command) 

lpar (‘'str‘ ] 


{lipar [check ]{ keyword |Sname} 


/nane (line? [(iine2 }] 


{linenuaber ({incrensent j] 


lpar (‘*str*j 
lpar 

lpar (‘str* } 

keywor d=value 

lpar 


{LEFT | RIGHT} count 


Modifiers and Xec Switches 


A 


x 


CHL PC Y 


mM 


= eM 


eM OO 


Xx 


me 


¢ 
~ 


x 
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F EOF 


x 


oe 


ne 
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Prototype: 


Action: 


Modifiers: 


Xec Settings: 


Examples: 
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ALTER 
EDIT COMMAND DESCRIPTION 


i) ALTER lpar ‘stringi'string2! 
ii) ALTER lpar 


This command causes the first occurrence (or all occurrences 
if the @A modifier appears) of "string!" in the given line 
nuaber and column range to be replaced by "string2". If no 
strings are supplied, the pair of strings given in the 
preceding ALTER with strings specified is used. 


@A, @CH, @NCH, @PC, @V, @NV, @X, @NX, OL, @NL 

ALTER succeeds if "string1" is found at least once and fails 
otherwise. The end-of-file switch is turned on if the 
end-of-file is encountered. 

ALTER 'ITtIs¢ 


causes the first occurrence of IT in the given coluan 
range of the current line to be altered to IS. 


A@A@X /FILE 'C1*#2¢ 


causes all occurrences of the hexadecimal string C1 (the 
character A) in the given column range of the entire 
file to be altered to hexadecimal E2 (character S). 
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Prototype: 


Action: 


Modifiers: 


XYec Settings: 


Example: 
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ELANK 
“BDIT COMMAND DESCRIPTION 


i) BLANK lpar ‘string 
ii) BLAWK Ipar 


If a string is given, this command causes the given line 
number range to be blanked according to that string, that is, 
positions in the line corresponding to blanks in the string 
are replaced with blanks; positions corresponding to non- 
blank characters are not changed. If. no string is given, 
each line of the given range is typed on the user's terainal 
and he is then prompted (with a "?") to enter a line to be 
used as the blanking pattern for the line typed. 


aCH, O@NCH, @V, ONV, OL, A@NL 


The end-of-file switch is turned on if the end-of-file is 
encountered. 


B * "ARA ‘ 


causeg the fourth through sixth characters of the 
curreat line to be replaced by blanks. 
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CHANGE 
EDIT CCMMAND DESCRIPTION 
Prototype: i) CHANGE lpar ‘string1'string2' 
ii) CHANGE lpar 
Action: The 


CHANGE comsand is a synonym for the ALTER command. See 
the ALTER command description abore. 
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EDIT CCHMAND DESCRIPTION 
Prototype: 1) CHECKPOINT 
ii) CEECKPOINT OFF 
Action: The checkpoint/restore feature provides the capability to 


establish a base or checkpoint in editing to which all or any 
part of the file may be restored (see the RESTORE command). 


CHECKPOINT with no parameter causes the current checkpoint 
buffer to be reinitialized or, if it is the first instance of 
the CHECKPOINT command, causes a one page buffer to be 
obtained and initialized (additional buffers are obtained as 
needed). CHECKPOINT OFF causes the current buffer to be 
released and the checkpoint feature to be disabled. 


Modifiers: None. 


Xec Settings: None. 
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Prototype: 


Action: 


Modifiers: 


Xec Settings: 
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COLUMN 
EDIT COMMAND DESCRIPTION 


i) COLUMN a n 
ii) COLUMN o 
iii) COLUMN 
where "mn" and "n" are positive integers. 


The first form of this command sets the coluan pointers to 
the "mn" and "n"th columns, respectively. The second form 
sets the pointers to "m" and 255, and the third resets then 
to their initial values, 1 and 255. The column pointers are 
used by the ALTER, BLANK, MATCH, OVERLAY, SCAN, and SHIFT 
commands as limits for editing in any given line. The coluan 
range is defined as extending from the character pointed to 
by the first coluran pointer through that pointed to by the 
second pointer. 


None. 


None. 
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SOPy 
EDIT CCMMAND DESCRIPTION 
Prototype: i) COPY lpar (TO] linenuaber 
ii) COPY lpar [TO] 
Action: This command causes the specified line number range to be 


copied (without being deleted) into the file immediately 
between the line whose line nuaber is given in the T0 field 
and the following line; the second fora defaults the TO field 
to the current line. Note that if lowercase conversion is 
enabled, the word "to" (if used) gust be in upper case. 
Note that the ambiguous command 

COPY linenuaber! linenuaber2 
is interpreted as meaning 

COPY linenurgber! linenuaber2 TO * 
not 

COPY linenusberl TO linenusber2 

Modifiers: @CH, @NCH, @V, ONV, @L, @NL 


Nec Settings: None. 
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Prototype: 


Action: 


Modifiers: 


Xec Settings: 
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DELETE 
EDIT COMMAND DESCRIPTION 


DELETE lpar 


This command causes the lines of the given line number range 
to be deleted from the file. 


If the user intends to delete a large set of contiguous lines 
from his file, he should use the MTS COPY command to copy the 
retained portions of the file to a temporary file. The 
original file can then be emptied and the temporary version 
can be copied back. This method is amore efficient. 


@CH, @NCH 


The end-of-file switch is turned on if the end-of-file is 
encountered. 
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Prototype: 


Action: 


Modifiers: 


Xec Settings: 


Example: 
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DOCUMENT 
EDIT COMMAND DESCRIPTION 


DOCUMENT lpar 


The DOCUMENT command is intended to be used in adding 
comzments to asseably language programs. It causes each line 
of the given line nuaber range to be typed out, followed by 
the editor's issuing a "?" to prompt the user to enter a 
comment to be appended to the line typed out. The comment is 
placed at the location marked by the first column pointer, or 
if the text already extends beyond the first column pointer, 
after the text with one intervening blank. If the comment 
extends the line beyond coluan 70, the comment is broken at a 
blank (or if it contains no blanks, at column 70) and 
continued on a line inserted after the line typed out. 


None. 


The endeof-file switch is turned on if the end-of-file is 
encountered during the documenting operation. 


cOL 28 

Doc * 

LABELA AH 2,8 

?NOW ADD B TO COMPUTE NEW INCREMENT FOR LINE NOMBER POINTER 
PPI@ NI 


LABELA Al 2B NOW ADD B TO COMPUTE NEW INCREMENT 
+13NV 

PRI@NL 

* FOR LINE NUMBER POINTER 
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Prototype: 


Action: 


Modifiers 


XYec Settings: 
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EDIT 
EDIT COMMAND DESCRIPTION 


EDIT filename 


This command causes the editor to release the file currently 
being edited and to obtain the specified file for editing. 
Line number ranges have no effect. Explicit concatenation 
may not be specified. The file editor operates with implicit 
concatenation off. 


If checkpointing is enabled, it remains enabled, but the 
checkpoint status is reset to one empty buffer, that is, the 
effect is the same as if 

CHECKPOINT OFF 

EDIT filenane 

CHECKPOINT 
had been specified. 


If EDITAFD is ON, "“"filename" becomes the currently active 
file (#*AFD*). 


None. 


The end-of-file switch is turned on if the new file is empty. 
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EXPLAIN 
EDIT COMMAND DESCRIPTION 
Prototype: i) EXPLAIN 
4i) EXPLAIN command 
4ii) EXPLAIN ERROR 
Action: The EXPLAIN comaand provides information about the syntax and 


operation of file editor commands. The first fora provides 
general inforsation. The second form provides information 
about the specified command. The third form is used when the 
BRIEF switch is enabled (see the SET command) to explain the 
last preceding error comment. 


Nodifiers: None. 


Kec Settings: None. 
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Prototype: 


Action: 


Modifiers: 
Xec Settings: 


Examples: 
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GOTO 
EDIT CCMMAND DESCRIPTION 


i) GOTO label 
ii) GOTO label [ON] condition 


where "condition" is any of SUCCESS, S, FAILURE, F, 
ENDOFFILE, EOP, or E. 


The GOTO command is used inside Xecs to alter the sequential 
interpretation of commands. The first form specifies an 
unconditional transfer to the command with the given label; 
the second form specifies a transfer if the specified 
condition is met. The label may be one to eight non-blank 
characters, There are two predefined labels, namely COUNT 
and END. COUNT causes the interpretation count to be 
decremented by one and interpretation to be continued fros 
the beginning of the Xec. END causes the Xec to be 
terminated immediately. 


None. 
None. 


See the XEC command for examples. 
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Action: 


Modifiers: 
Xec Settings: 


Pxrasples: 
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LHSERT 
EDIT COMMAND DESCRIPTION 


i) J[NSERT linenuraber ‘string' 
ii) INSERT ‘string’ 
iii} JNSERT linenusaber 

iv) INSERT 


The INSERT command with a string specified causes that string 
to be inserted as a line into the file between the line with 
the given line number (which defaults to the current line if 
no line number is specified) and the succeeding line. If no 
string is specified, the editor enters fast insertion sode. 
In this mode of operation, all lines entered up to a null 
line or an end-of-file are inserted between the specified (or 
defaulted) line and the following line. The line numbers are 
calculated by an algoritha which varies the increment depend- 
ing on the difference between the line number of the last 
line inserted and the following line. 


If the g{ven line number does not correspond to any line in 
the file, the first line is inserted there. 


@CH, @NCH, OV, O@NV, @X, ONX, aL, ONL 
None. 

IN "NEW LINE®* 

causes the line 

NEW LINE 

to be inserted after the current line. 
zi 320 

?line 1 

Fliine 2 

Vline 3 

?7SENDPILE 


inserts the given three lines after line 320. 


286 IWSERT Edit Comsand 


April 1974 


Prototype: 


Action: 


Modifiers: 


Xec Settings: 
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LINE 
EDIT COMMAND DESCRIPTION 


LINE linenuaber 


The LINE command causes the given line number to become the 
current line number. 


OV, O@NV, OX, O@NX, OL, ONL 


The LINE command turns the end-of-file switch on if no line 
with the given line number is found in the file. 
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BATCE 
EDIT COMMAND DESCRIPTION 
Prototype: i) MATCH lpar ‘string' 
ii) MATCH lpar 
Action: MATCH causes the editor to search the given line number range 


of the file for a line that matches the given string starting 
at the left column position. Positions in which the current 
fill ‘character (see the SET command) occur in the string 
“watch any chatacter in the cortesponding position in the 
coluan range. If no string is given, the string given in the 
previous MATCH with a string is used. 


Modifiers: @k, @V¥, O@NV, @X, ANX, OL, @NL 

Yec Settings: MATCH succeeds if the given string is found at least once, 
and fails otherwise. The end-of-file switch is turned on if 
the end-of-file is encountered during snatching. 


Exargple: COL 10 15 
MATCH@A /PILE ‘BAL e 


This example of the MATCH command can be used to match 


all oceurrences of the BAL or BALR instruction in an 
assergbly language prograsl. 
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Prototype: 


Action: 


Modifiers: 
Xec Settings: 


Example: 
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Brs 
EDIT CCHMAND DESCRIPTION 


i) mrs 

ii) BIS command 

The first form of this command returns control to the MTS 
command level. The second form returns control to MTS and 
issues the MTS command given in the parameter field. In 
either case, the editor may be reentered by issuing the S$EDIT 
command. 


All Xecs and line number regions remain defined. All switch 
values changed with the SET edit command remain in effect. 


The name of the file being edited is saved for use with a 
future SEDIT command. See the S$EDIT MTS command description 
for details. 

None. 

None. 


MTS SLIST FILEA 


causes control to be returned to MTS and the file FILEA 
to be listed. 
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| Action: 


Modifiers: 


XYec Settings: 


Example: 
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QVERLAY 
EDIT COMMAND DESCRIPTION 


i) QVERLAY lpar ‘string! 
ii) OVERLAY lpar 


The first form causes the specified line nuaber range to _ he 
overlaid with the given string. The second form causes the 
given coluan range of each line to be printed followed by the 
editor issuing a "2?" as the prompting character and awaiting 
a line entered by the user to be used to overlay the line 
typed. OVERLAY causes characters in the string or line 
entered to replace the characters in the corresponding 
positions in the coluan range. Where the fill character 
occurs in the string or the line entered, the coresponding 
character in the line overlaid is left unchanged. The 
initial fill character is the blank. It may be changed with 
the SET comaand. 


@CH, @NCH, @V, @NV, @L, @NL 


The end-of-file switch is turned on if the end-of-file is 
encountered during the overlaying operation. 


If the coluan pointers are set to 1 and 255 and the current 
line is 


THEN AND THERE 

then the command 
OVERLAY ‘now ¢ 

causes the current line to becone 
NOWN AND THERE 

while 


SET FILL=% 
OVERLAY ‘now * 


causes it to beccne 


NOW AND THERE 
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Prototype: 


Action: 


Modifiers: 


Xec Settings: 


Examples: 


MTS Volume 1: MTS -= The Syster 


PRINT 
EDIT COMMAND DESCRIPTION 


i) PRINT lpar 

ii) PRINT lpar check 
iii) PRINT keyword 

iv) PRINT $name 
where "check" is one of CHECKPOINTED, CHECKPOINT, CHECK, or 
CH and "keyword" is one of COLUMNS, C, FILE, F, REGIONS, R, 
XECS, or X. 


"PRINT lpar® causes the lines of the given line number range 
to be printed. 


"PRINT lpar check" causes the lines in the given line number 
range which have been changed since the last CHECKPOINT 
command to be printed in their checkpointed forms. 


"PRINT COLUMNS" or "PRINT C" causes the values of the current 
column pointers to be printed. 


"PRINT FILE" or "PRINT F"® causes the name of the file being 
edited to be printed. 


“PRINT REGIONS" or “PRINT R"® causes the names of the currente- 
ly defined regions to be printed. 


"PRINT XECS" or "PRINT X" causes the names of the currently 
defined Xecs to be printed. 


"PRINT $name" causes the commands in the Xec named $name to 
be printed. 


“PRINT lpar"® and "PRINT lpar check": @L, ONL, @X, @NX 
Other forms: None. 


None. 
PaxX@L /FILE 


causes the entire file to be printed in hexadecimal with 
line nugber prefixing. 
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PSA 


causes the contents of the Xec named $A to be printed. 
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Prototype: 


Action: 


Modifiers: 
Xec Settings: 


Example: 
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REGION 
EDIT COMMAND DESCRIPTION 


i) REGION /nane linenurgber1 linenusber2 

ii) REGION /name linenusber 
iii) REGION /nanze 
where "/nane* is a region nane. 
The REGION command defines the line number range to be 
associated with a region name, either "“‘linenuraber1" through 
"“linenuaber2", "“‘linenuaber® alone, or the current line nun= 
ber, respectively. 
None. 
None. 


REG /A 


causes the current linenumber to be associated with the 
region name /A. 
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Prototype: 


Action: 


Modifiers: 


Xec Settings: 
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RENQURER 
EDIT COMMAND DESCRIPTION 


RENUMBER linenumber incresent 


The RENUMBER command causes the entire file to be renuabered 
beginning with “linenurber" and increasing by “increment". 
The “linenurber" and “increment" parameters both default to 1 
if not specified and both may assume positive, negative, and 
zero values. 


fhe following system or user actions may cause either the 
entire contents or part of the contents of the file to be 
lost: 


1) any action which results in the user being signed 
off, such as systen failure or time limit exceeded, 


2) any combination of "linenumber" and “increrzent" which 
causes a line number greater than 99999.999 or less 
than -99999.999, or 


3) an attention interrupt issued during execution of 
this command. 


These probleas are created by the method used to renuaber the 
file. The editor copies the entire contents of the file to a 
file named "-EDQQSV", empties the file being edited, and 
copies the contents back. If the file has been copied to 
-BDQQSY and any of the abowe three conditions occur, a part 
or all of the file contents may be lost. 


@cH, @NCH 


None. 
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REPLACE 
EDIT COMMAND DESCRIPTION 
Prototype: i) REPLACE lpar ‘string! 
ii) REPLACE lpar 
Action: REPLACE causes the lines in the line number range to be 
replaced by the given string. If no string is given, each 
line is typed and the user is prompted with a "2?" to enter a 
replacement line. 
Modifiers: @CH, @NCH, @V, @NV, @X, O@NX, OL, ONL 


Xec Settings: The end-of-file switch is turned on if the end-of-file is 
encountered during the replacing of lines. 
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RESTORE 
EDIT CCHMAND DESCRIPTION 
Prototype: RESTORE lpar 
Action: RESTORE causes the lines in the given line number range to be 


restored to their condition at the time of the last CHECK= 
POINT command if the checkpoint/restore feature is enabled. 


Note that 
RESTORE 
is the same as 
RESTORE * 
and only restores the current line. If the entire file is to 
be restored to the condition before the last CHECKPOINT 
comrand, 
RESTORE /FILE 
should be specified. 
Modifiers: av, O@NV, @X, @NX, @L, NL 


Xec Settings: None. 


- 296 RESTORE Edit Command 


April 1974 


Prototype: 


Action: 


Modifiers: 


Xec Settings: 


Example: 


MTS Volume 1: MTS -- The Systen 


SCAN 
EDIT CCMMAND DESCRIPTION 


i) SCAN lpar ‘"string'* 
ii) SCAN ipar 


SCAN causes the editor to search the current column range of 
the given line nurgber range for the first occurrence (or, if 
the @A rodifier appears, all occurrences) of the given 
string. If no string is given, the string given in the 


’ previous SCAN command with a string is used. The last line 


found containing the string becomes the current line, and, if 
the @PC modifier appears in the command, the column at which 
the first character of each occurrence of the string begins 
is printed. 


@A, OPC, OV, O@NV, OX, ONX, @L, ONL 

SCAN succeeds if the given string is found at least once and 
fails otherwise. The endeof-file switch is turned on if the 
end-of-tile is encountered during scanning. . 


coL 10 15 
SCAN@A@PC /FILE ‘BALR® 


finds all occurrences of the BALR instruction in a 
standard-format 360 assembler prograa. 
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SEZ 
EDIT CCMMAND DESCRIPTION 
Prototype: | SET keyword=value 
Action: The SET command is used to alter the values of a number of 


switches which gevern the editing process and to change the 
fill character. : 


The switch keywords may take the values ON or OFF. The 
keywords, their abbreviations, and their meanings are as 


follows: 

BRIEF B When BRIEF is ON, errors are signaled by 
the message "ERROR" and the complete 
message may be obtained by issuing the 
command “EXPLAIN ERROR". 

Default: OFF. 
ce When CC is ON, lines from the file are 


printed with carriage control. 
Default: OFF. 


CHECKPOINT CHECK If a checkpoint buffer has been allocated 
c and the CHECKPOINT switch is ON, changes 
to the file are recorded by the 
check point/restore feature (see the 
CHECKPOINT and RESTORE comeands). 
Default: ON. 


ECHO E. When ECHO is ON, commands entered froa 
the source stream and those read from 
Xecs are echoed on SPRINT. 
Default: ON (batch), OFF (terminal). 


ERROREXIT ERROR When ERROREXIT is OW and an error occurs, 
ERR the editor terainates execution by 
ER calling ERROR after printing the appro- 
priate error message. 
Default: ON (batch), OFF (terminal). 


FILL F The £111 character is set to the single 
character following the equal sign of the 
keyword expression. The fill character 
is used in the MATCH and OVERLAY 
commands. 

Default: blank 
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Modifiers: 
Xec Settings: 


Exauples: 


HEX H 


LINENUMBER LNR 


L 
TRIM T 
VERIFY v 


None. 
None. 
SET VERIFY=ON 


SET FILL=$ 
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When HEX is ON, input strings are con= 
werted from hexadecinal to internal 
character form on input, and output lines 
are printed in hexadecimal format. 
Default: OFF. 


When LINENUMBER is ON, the line number of 
each output line is printed before the 
line. 

Default: ON. 


When TRIM is ON, lines written into and 
read from the file are trimmed of trail- 
ing blanks. 

Default: OFF. 


When VERIFY is ON, edited lines are 
printed following the execution of the 
ALTER, BLANK, CHANGE, COPY, INSERT (only 
the form with a string), LINE, MATCH, 
OVERLAY, REPLACE, RESTORE, SCAN, SHIFT, 
-n, and +n commands. 

Default: ON. 
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Prototype: 


Action: 


Kodifiers: 


XYec Settings: 


Exargple: 
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SHEET 
EDIT COMMAND DESCRIPTION 


SHIFT lpar direction count 


where "direction" is LEFT or L, RIGHT or R and "count" is an 
integer satisfying 1 < “count" < 255. 


SHIPT causes the contents of the given column range of the 
given line nuaber range to be shifted in the given direction 
by “count"® characters. Blanks are shifted into the positions 
wacated. 


@CH, @NCH, @V, O@NV, OX, @NX, OL, ONL 


The end-of-file switch is turned on if the end-of-file is 
encountered during shifting. 


CoOL 10 15 


SHIFT * LEFT 2 
would change 
| ABCDEFGHIJKLMNOPQRSTUVSXYZ 
to 


ABCDEFPGHILMNO POQRSTUVWXYZ 
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Prototype: 


Action 


Modifiers: 


Xec Settings: 
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STOP 
EDIT COMMAND DESCRIPTION 


STOP 


STOP causes the file editor to return to MTS and to release 
its control storage. Thus, the next EDIT command enters the 
editor with the default switch settings, column range, and 
regions (/FILE, only), and with no XECs defined. This is the 
same as if the editor had not been used before. See the 
SEDIT MTS command for details. 


None. 


None. 
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Prototype: 


Action: 


Wea fiers: 


Xec Settings: 


Exaaple: 
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XEC 
EDI? COMMAND DESCRIPTION 


ZEC $nane 
where "Snate" is an Xec nase. 


A onew Xec name is created. All the commands entered until 
the next null line, end~of-file, or END command become the 
text of the xec. See the discussion of Yec procedures above 
for the détails of using Xec definitons. 


one. 
Not applicable. 


The following Xec could be used to print the first ESD line 
and the END line of each object module in a file: 


XEC $A 

LINE *F 

A:HAT ® *L * ESpt 
GOTO END ON EOF 
MAT * *L ¢ END! 
GOTO A 

END 


The following Xxec could be used to locate all lines that have 
either an "&" or a "." in coluan 1 (or whichever is selected 
by the column range). 


XEC $B 

LOOP: A * * "6? 
a * # ¢,8 

Vanv . 
GOTO END ON EOF 
GOTO LOOP 

END 
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Prototype: 


Action: 


Modifiers: 


Xec Settings: 
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+n, on 


EDIT CCMMAND DESCRIPTION 


i) na 
ii) +n 
iii) -n 7 


where "n* is an unsigned integer. 
This command causes the current line pointer to be moved 
forward or backward by "n" lines. The sign of the nuaber 
indicates the direction to move, 
Thus, if the current line is 4, the command 

1 


moves to the next line (which is not necessarily 5) and 
subsequently 


-2 


moves to the line preceding line number 4 (which is not 
necessarily 3). 


@V, ONV, OX, O@NX, @L, A@NL 


The end-of-file switch is turned on if the end~of-file is 
encountered in either direction. 
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Prototype: 


Action: 


Modifiers: 


Xec Settings: 
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Spage 
EDIT CCMMAND DESCRIPTION 


i) Spape count 
ii) Snape 


where "Snage" is an Xec name and "count" is a positive _ 
integer. “4 


This conmand initiates the execution of the Xec naned 
"$name", If no count is given, it is assumed to be one. Tf 
the Xec does not contain GOTO commands, the sequence of 
conmands is executed “count" tines. Tf the Xec contains 
GOTOs, the sequence of control and the number of times each 
command is executed is deterained by the interaction of the 
count and the GOTO commands. 


None. 


None. 
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Zpanme 
EDIT CCMMAND DESCRIPTION 

Prototype: Zname 

where "/name"* is the name of a region. 
Action: This command causes the line numbers which are the bounds of 

the given region to be printed. 
Modifiers: None, 


Xec Settings: None. 
Example: /PILE 
causes the line numbers 
~99999.999 99999.999 


to be printed. 
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DEBUG MODE 


the Symbolic Debugging System (SDS) is a conversational facility for 
testing and debugging programs. This facility was originally provided only 
for 360-assembler language programs, but it has now been extended to include 
FORTRAN programs. SDS enables the user to initiate the execution of a 
program and monitor its performance by displaying or sodifying instructions 
and data at strategic points in the progran. 


SDS may be invoked in an active manner with the MTS command 
STEBUG FDname 


where FDname is the file(s) containing the program to be debugged. The 
parameters to the $DEBUG command are the same as those for the $RUN command; 
hence, if the program refers to logical I/O units or has a system parameter 
field, these also may be included on the $DEBUG command. For example, 


SDEBUG PROGRAM SCARDS=INPUT SPRINT=OUTPUT PAR=EXEC 


The user communicates with SDS by entering debug commands from his 
terminal. SDS signals its readiness to accept a command by printing the 
prefix character "+" in column one. This prefix character precedes all SDS 
messages and diagnostics. Initially, commands to SDS are read from the 
pseudo=device *SOURCE* and SDS output messages and error diagnostics are 
written on *SINK*. Commands may be entered in either the upper or lower 
case. 


When the program has been successfully loaded, SDS prints 


+READY 
+ 


at which point SDS is ready to accept its first debug command. A command is 
a request that SDS do something with the program being debugged. For 
instance, the RUN command initiates execution of the program, and the MAP 
command lists relevant information about each loaded section. The BREAK 
command is provided to insert breakpoints at strategic locations in the 
program. If a program interrupt occurs during execution, or if a breakpoint 
is encountered, control is returned to SDS which explains why the prograna 
has stopped running and requests another command. The DISPLAY command may 
then be used to selectively examine specific locations in memory or the 
contents of the general and floating-point registers. Changes to data and 
to instructions say be made with the MODIFY command. The program may be 
restarted with the CONTINUE command. In this manner, the user may "step" 
through the program and monitor its performance. A complete description of 
the debug command language appears at the end of this section. 
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Logical 1/0 unit assignments and the value of the system paraseter list 
may be specified on the SDEBUG command in the same format as the SRUN 
command. 


If the user has omitted these assignments from the $DEBUG command, or 
desires to change or reset any of the assignments, he may do so with the SET 
debyg command. For example, after issuing the MTS command 


SDEBUG -LOAD 
the debug command 
SET 5=DATA 6=RESULTS PAR=LIST 


assigns the files DATA and RESULTS to logical I/O units 5 and 6, 
respectively, and sets the system parameter list to the character string 
LIST. This is the same as if the MTS command 


SDEBUG -LOAD 5=DATA 6=RESULTS PAR=LIST 
had been issued originally. 


Assigning logical I/O units with the SET command may be used to 
reposition files but does not affect the status of other types of 
pseudo-devices (such as *SOURCE*® and the position of tapes). The PAR option 
must be the last parameter specified since the remainder of the input line 
is taken as the system parameter list. 


An alternative method for invoking SDS is with the HTS command 
$SEBT DEBUG=ON 


This method uses SDS in a passive manner. All programs loaded after this 
point are processed by SDS. The MTS commands of $S$RUN and SSTART/SRESTART do 
pot start execution of the program directly, but transfer control to SDS 
with an implicit debug comm#and of RUN or CONTINUE (respectively). SDS 
intercepts any error that occurs, prints an error comment, and returns to 
MTS command anode. At this point the user, if he desires, may explicitly 
enter debug command mode with the MTS cosmand 


$sDS 


to determine what went wrong with his programs. This mode of operation may 
be disabled by the MTS command 


SSET DEBUG=OFF 


The default for the DEBUG option is OFF. When the DEBUG option is ON, 
all user programs, language translators, and other publicly available 
programs are processed by SDS; hence, the user should be aware of which 
programs he does and does not want SDS to process. Normally, when the user 
is not running one of his own prograas, the DEBUG option should be OFF. 
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DISPLAY AND MODIFY PROCESSING 


SDS_Parameters 


The most useful facility of SDS is the ability to selectively refer to 
locations in the program being debugged. This may be done syabolically, by 
relative address, or by absolute (virtual) address. In the symbolic mode, a 
location is referred to by the symbol assigned to that location at program 
translation tine. 


Syabolic referencing is possible only with those language processors 
which generate a symbol table with the object programs they produce. 
Currently, this is done by the 360 Level G Assembler (*ASNG) and the FORTRAN 
G compiler (*FTN). With *ASMNG and *FTN, the TEST parameter must be 
specified for the processor to produce symbol table information. The 
formats are: 


SRUN *ASMG SCARDS=source SPUNCH=object PAR=TEST 
SRUN *FTN PAR=SOURCE=source,LOAD=object, TEST 
When referencing by relative or virtual addresses, SDS processes all 
loaded programs which were produced by a language translator that generates 
an object module. This excludes interpretive translators such as WATFOR and 
SNOBOLG. 
The general format for an SDS parameter is 
S (i) tj 
"S" may be 
(1) a symbolic location appearing in a source language progran, 


(2) a relative address assigned at assembly or compilation time, or 


(3) an absolute (virtual) address corresponding to a location. within 
the loaded progran. 


"i", the index, may be a signed or unsigned decimal integer which 
represents the ith translated element (that is, an instruction, or data 
item) starting with or preceding S. $(0) and S(1) are identical to Ss. 
Recursively, "i" may also be an entire SDS parameter of the form S(i)+j. 
For FORTRAN arrays, “i* may be a series of indices, separated by commas. 


nj", the displacement, may be an unsigned hexadecimal integer which 
represents the number of bytes following or preceding the location specified 
by S(i). 


An SDS parameter is terminated by a blank or by a zero-level comma (a 
comma which is not contained in a parenthesized expression). 
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The SDS indexing mechanisry ignores zero duplication factors and asseabler 
generated spaces. In the 360 asserbler example below, HW(2) refers to the 
same location as CH; HW(3) and CH(2) both refer to the game location as FW. 


000020 0009 AW pe HY9¢ 
000028 Ds 0D 
000028 c1c2c3cacsao Cl DC C*'ABCDE * 
000030 00000005 FW pe Fess 


Illegal operation codes do not terminate SDS indexing operations. The 
instruction is assumed to be 2 bytes in length (RR type) and indexing 
proceeds. 


Both the index and the displacement are optional. Examples of legal SDS 
parameters are: 


ALPHA 
ALPHA (2) 
ALFHA (=3) 
BETA+20 
BETA (6) +4 
BETA (8)=C 


Recursively, "i" may be an entire SDS parameter of the form S(i)tj. The 
index "i*® is assumed to be a decimal integer unless it is a symbol or a 
relative or absolute address (with the @R or @A nodifiers appended). When 
the index is a symbol or an address, the contents of the location specified 
is used as the index for the indexing operation. As many levels of 
recursion as desired may be specified, for example, 


A(T) 
B(A(T)) 

Cc (B & (3))) 
D(20@R) 


Yor FORTRAN arrays, "i" may be a series of indices separated by commas. 
Up to seven indices may be specified, corresponding to the nusber of 
dimensions in the array. Alternatively, any PORTRAW array may be referred 
to linearly {with one index). For exasple, 


A(€) 
B(4,3) 
C$ (1929304 9556,7) 


Symbolic indices may also be used, for exaagple, 


A(T) 
B(J,K) 


To refer to staterzent numbers in FORTRAN prograns, a prefix must be used 
to distinguish the statement nuaber from a relative address. The "#" sust 
prefix the statement number if it is an external (user-defined) statement 
number. For exasple, 
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#10 


is the user-defined statement number 10. "IS#" must prefix the statenent 
number if it is an internal (source~listing) statement number. For exaaple, 


Is#10 


is the source-listing statement number 10. Only those statesent numbers 
which define executable FORTRAN statements may be used. An executable 
statement is defined as a statement which is from one of the following 
categories: 


(1) Assignment statements 
(2) Control statements 
(3) 1/0 statenents 


All others, such as those defining DIMENSION, REAL, INTEGER, DATA, COMMON, 
SUBROUTINE, FUNCTION, ENTRY, EQUIVALENCE, and FORMAT statements are non- 
executable and therefore undefined. Both internal and external statement 
numbers must be specified without leading zeros. 


It is frequently necessary to distinguish explicitly between a symbolic, 
a relative, or an absolute address. For example, "A14" could be interpreted 
as the symbol "A14", or the relative or absolute address A14 (hex). To 
indicate a relative or absolute address, the @R or @A modifiers may be 
appended to any parameter; hence, “"A14@R" becomes the relative address A14 
(hex). If the parameter name begins with a letter, it is assumed to be a 
symbol. Thus, "A14" is treated as a symbol, and to specify the relative 
location A14 either "0OA14" or ®A1UaR" must be specified. 


If the parameter is greater than or equal to 100000 (hex), the address is 
assumed to be absolute and the @A modifier need not appear. If the 
parameter is less than 100000, the address is assumed to be relative. 


The @Q modifier forces any string of characters to be treated as a 
symbol. 


SDS assumes all indices are decimal and all displacements are hexadecinal 
unless overridden by the @X or @D aodifiers. The @X modifier specifies 
hexadecimal conversion of an integer constant, while the aD specifies 
decimal conversion of an integer constant. The @X and @D modifiers affect 
only the immediate numbers to which they are appended. 
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The following 360 assembler language prograa illustrates the use of SDS 
paraszeters. 


000000 PROG CSECT 
000000 USING *,15 
000000 5810 FOT4 L 1, ALPHA 
000004 5a10 FO18 AD A 1,€ 
000008 5010 FO1T4 st 1, ALPHA 
00000C 58A0 FO1IC L 10,VSYS 
000010 O7FA BR 10 
000014 0000000A ALPHA DC F‘10' 
000018 00000014 c DC F'20° 
00001C 00000000 VSYS DC Fsd«W (SYSTEM) 
000020 GAMMA DS 20P 
000070 1€022C333C1C022C DELTA pc 2P*1,22,333' 
END 


The following is a list of SDS parameters and the corresponding relative 
addresses. 


Paraneter Address 
PROG 000000 
PROG+4 000004 
PROG (7) 000018 
AD 000004 
AD (+1) 000000 
Apes 000008 
C 000018 
c (0) 000018 
c (1) 000018 
c+c 000024 
vsYs 00001C 
VSYS-10aX 00000c 
VSYS=10 00000Cc 
VSYS-104aD 000012 
VSYS=A 000012 
GAMMA 000020 
GAMBA (20) 00006c 
GAMMA (C). 00006c 
DELTA (3) 000073 
DELTA (- 22) 000018 
car 00000c 
CaR (2) 000010 
CaR-4 000008 
CaRrec 000018 
40 (2) 000014 
204A 00002A 
70 000070 
70 (2) 000071 
70 (3) 000073 
70(4) 000075 


70 (5) 000076 
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To display the current value of a location, the DISPLAY command may be 
used. For exanple, 


DISPLAY ALPHA 


converts the location ALPHA according to its type and length and prints the 
result. The type refers to the format in which it is displayed (that is, 
fixed-point, floating-point, character, hexadecizal, etc.) and the length 
refers to the number of bytes printed. The ALPHA from the above progras is 
displayed as 


ALPHA "Ft +10 

Locations may also be referred to by the relative addresses assigned at 
translation tine. To display the contents of the relative location C, the 
command 

DISPLAY C@R 
may be used. This displays the instruction in the form 
AD(3) ‘'I* L  AaoOFO1c 

The @R modifier is used to indicate a relative address. If no symbol table 


is provided at translation time, the location is printed in hexadecimal 
format as 


00000C "xX" S8A0FO1C 


The user may specify a relocation factor with the SET debug command. 
This relocation factor is added to every relative address specification that 
is not overridden by the @C modifier. For example, the command sequence 


SET RF=517000 
DISPLAY 2A0 


displays the contents of locaticn 5172A0. 


The user may display any legal location in his virtual memory by 
specifying an absolute (virtual) address. To display the contents of the 
absolute location 516A28, the command is 


DISPLAY 516A28 


If possible, the contents of 516A28 are converted according to type and 
length and printed on the user's terminal. If the address given specifies 
an illegal, an unreferenced, or a protected page, an error message is 
printed. 


A special form of the SDS parameter, the block parameter, is provided to 
specify a range of locations. For example, to display the linear array XVAL 
of dimension 10, the command 
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DISPLAY XVAL(1)...XVAL (10) 


is. used. If the symbol used for the upper~bound address is identical to 
that of the lower-bound address, it may be omitted, for example, 


DISPLAY XVAL(1}..+ (10) 


Block parargeters may be used to specify any range of addresses as shown in 
the following examples: 


DISPLAY ALPHA...GAMMA (2) 
DISPLAY 9C0...A28aR 
DISPLAY 516000...516428 


The upper-bound address must be greater than the lower-bound address. 


Keyword Modifiers 


It is often useful to override the implied or assumed type, length, or 
scale attributes of an SDS parameter. SDS provides a set of keyword 
modifiers which temporarily override the attributes of a parameter by 
explicitly specifying new attributes. A keyword modifier consists of the 
modifier character "a" followed by a keyword describing the modifier. For 
instance, the user may wish to display a syrabol in its hexadecimal 
representation. In the following example, the TYPE keyword modifier is 
applied to the symbol ALPHA. The one character code following the "=" is 
the type code for hexadeciaal formatting, as defined below. The command 


DISPLAY ALPHA@TYPE=X 
displays the contents of ALPHA as 
ALPHA 'x* 0000000A 
If a length attribute of 8 is also applied, the command is 
DISPLAY ALPHA@TYPE=XaL ENGT H=8 
and the symbol is displayed as 
ALPHA *x* 0000000A 00000074 


Only the first letter of any keyword modifier need be entered. Hence, 
the preceding exaaple could be given as 


DISPLAY ALPHA@T=XaL=8 
As many keyword modifiers as needed may be appended to a parameter. For 


block parameters, the TYPE, LENGTH, and SCALE modifiers may be appended to 
either the upper bound or lower bound address, for example, 
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DISPLAY 516100@T=FaL=4...516120 


or 
DISPLAY 516100...516120@T=FaL=4 


It is often desirable to restrict the use of an SDS parameter to a single 
control section by the use of the CSECT keyword modifier. This is normally 
done when a symbol or relative address is defined in more than one control 
section. For example, 


DISPLAY SETA@C=SUBR 
displays the contents of locaticn BETA in the section SUBR. 


The symbol BLANK may be used for referring to blank named common 
sections. For example, the wariable A in a blank named common section of a 
FORTRAN program may be displayed by 


DISPLAY A@C=BLANK 


If the program already has a control section or common section by the name 
of BLANK, the SET command may be used to alter the blank named comaon 
symbol. The use of BLANK as a blank named common symbol does not interfere 
with the use of BLANK for other symbols in the progran. 


If a control section of a given name appears more than once in the 
program, the GEN keyword modifier can be used to specify the desired 
occurrence of that section. The first time a control section of a given 
name is loaded, it is assigned the generation number 1, the second time it 
is loaded, it is assigned the generation number 2, and so on. The command 


DISPLAY BETA@C=SUBR@G=2 


displays the contents of location BETA in the second occurrence of section 
SUBR. 


The DSECT keyword modifier can be used to restrict an SDS parameter to a 
particular dummy control section or dsect. If a dsect of a given name 
appears in more than one assembly, the desired dsect can be specified by 
appending the CSECT modifier immediately after the DSECT modifier. for 
example, 

DISPLAY LOC1@D=DAREA@C=SUBR 
displays the contents of location LOC1 in the dsect DAREA from the asseably 
containing the section SUBR. Dynamic or static addressability for the dsect 
must be provided by the USING command. For example, 
USING DAREA@C=SUBR GR1 


causes SDS to use the current contents of GR1 as the base address for DAREA. 


Debug Mode 315 


Pe eS C—O 


MTS Volume 1: MTS <= The Syste, 


April 1974 


For block parameters, the CSECT, GEN, and DSECT parameters apply only to 
the address (upper bound or lower bound) to which they are appended. 


SDS recognizes the following keyword modifiers: 


@TYPE=code sets the type attribute to code, where code is any of the 
single-character type-codes defined below. The default is 
xX. 


a 
{o] 
fa 
oO 


Zype 


Aetype address constant 
binary 

character (EBCDIC) 
floating-point (long or short) 
fixed-point integer 

machine instruction 

logical (FORTRAN) 

complex (PORTRAN) 

packed decinaal 

Setype address constant 
V-type address constant 
channel command word 
hexadeciaal 

Y-type address constant 

zoned decinal 
assembler-generated space (output only) 


eNOS EH Bete dO OO 


@LENGTH=i sets the length attribute to i, where i is an unsigned 
decimal integer. The default is 4. 


@SCALE=i sets the binary scale factor to i, where i is a signed or 
unsigned decimal integer. The default is 0. Binary scale 
factors follow -the conventions used by the 360 assembler 
language. 

aCSECT=cs restricts the parameter to the control section ¢s. 


@GEN=i restricts the parameter to the ith generation of the current 
control section. 


@aDSECT=ds restricts the parameter to the dsect ds. 


The following modifiers may be used to modify any constituent or keyword 
modifier in an SDS parameter: 


aQ Treat as a syrbolic location. 
aR Treat as a hexadecimal relative address. 
aA Treat as a hexadecigal absolute (virtual) address. 
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ax Cause hexadecimal conversion. 
aD Cause decimal conversion. 


The modifier character may be changed by the SET command, so that symbols 
containing an “@" character can be referred to in SDS parameters. 


Predefined Symbols 


SDS predefines a small number of "useful" symbols. For instance, to 
display the contents of all of the general registers, the predefined symbol 
"GRS" is used, thus, 


DISPLAY GRS 
causes the contents of the general registers (0-15) to be displayed. To 
refer to the ith general register, the symbol "GRi" is used, where "i" is a 
register number, ranging from 0 - 15, or 0 = 9 and A = F (hex). 
Similarly, to refer to the floating-point registers, the symbol "FRS" is 
used. To refer to the jth floating-point register, the symbol "FRI" is 
used, where "j" is 0, 2, 4, or 6. 


To refer to the current program status word (PSW), the symbol "PSW" is 
used. 


To refer to a program defined location with the same name as an SDS 
predefined symbol, the @Q modifier must be appended to the symbol. Thus, to 
display the program defined symbol GR7, the command 

DISPLAY GR70Q 
must be given, whereas, to display general register seven, the command 


DISPLAY GR7 


should be used. 


Indirection 


A level of indirection through any SDS parameter may be achieved by 
placing the indirection character "$" at the front of the parameter. The 
parameter is assumed to contain a fullword, byte aligned value which is used 
by SDS as_ the effective address. For example, to display the contents of 
the location whose address is contained in general register six, the command 
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DISPLAY $GR6 


is used; whereas, to display the contents of general register six, the 
command 


DISPLAY GR6 


is sufficient. As many levels of indirection as needed may be achieved by 
placing the appropriate number of indirection characters at the front of the 
parameter. For example, to display the location whose address is contained 
in the location pointed to by general register two, the command 


DISPLAY $$GR2 
is given. 


SDS stops at the first illegal address encountered and reports the 
indirection level. An illegal address is an address which specifies a 
protected page, an unreferenced page, or a noneexistent page. The chain of 
indirection need not be contained in SDS processed control sections. 


The indirection operator has higher precedence than “t" used to add a 
displacenent. For example, the expression SADDRt4 refers to the location 
which is 4 bytes past the address which is given in location ADDR. It does 
not use the contents of ADDR+4 as the location (S$). 


The indirection character may be changed by the SET command, so that 
symbols beginning with a "$" can be referred to in SDS parameters. 


ippyt Conversion 


Input conversion is used with the MODIFY and SCAN commands. The MODIFY 
command reguires two parameters: 


‘(1) an SDS parameter specifying what locations are to be sodified, and 

(2) a list of one or sore constants delimited with blanks or commas; 
the entire list is enclosed in prises. The constants are converted 
according to the type and length attributes of the first parameter. 


The SCAN command also requires two parareters initially: 


(1) a section name or block parameter specifying a region to be 
scanned, and 

(2) a single constant enclosed in primes. The constant is converted 
according to the type and length attributes applied to the first 
parameter. 


No modifiers may be appended to the constants themselves. Type, length, 


and iecale modifiers may be appended to the first parameter specified. 
Conventions for the representation of the different types of SDS constants 
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The TYPE keyword sodifier must be applied to the first 


parameter if the constant type does not agree with the parameter's default 
type. The term parameter refers to the operand which is being modified or 
scanned. An error comment is produced if an unsupported type is specified. 


A-type adcon - 
Binary = 
Character 7 
CCW - 
Complex - 


If the length of the parameter is three or four bytes, 
the constant may be any legal virtual address, relative 
address or program defined symbol. If the length of the 
parameter is one or two bytes, the constant is treated 
as a fixed-point decimal integer of length one or two, 
respectively. The example below aodifies the location 
ADDR to contain the address of the symbol LOOP. 


MODIFY ADDR 'LOOP* 
Not supported. 


Any of the valid 256 punch combinations may be desig- 
nated in a character constant. Only one character 
constant may be specified in the second operand of the 
MODIFY command. Since multiple constants within the 
second operand are separated by blanks or commas, an 
attempt to specify two character constants results in 
interpreting the comma or blank as a character. Special 
attention must be given to representing primes as 
characters. Each single prime as a character in the 
constant must be represented as a pair of primes. The 
maximum length of a character constant is 256 bytes. 
Double primes are counted as one character. For the 
MODIFY command, if the number of characters is less than 
the length of the parameter, the excess rightmost bytes 
are filled with blanks. If the number of characters in 
the constant exceeds the length of the parameter, an 
error message is given. For the SCAN command, the 
length of the constant is taken as the actual number of 
characters specified. In the example below, the loca- 
tion CHAR is modified to contain the character string 
ABCDE. 


MODIFY CHAR ‘ABCDE*t 
Not supported. 


A complex constant consists of a pair of floating-point 
constants, separated by a comma or a blank. The first 
constant is the real part and the second constant is the 
imaginary part. If only one constant is specified, only 
the real part is modified. The length of the entire 
complex constant is 8 or 16 bytes. Complex constants 
are used primarily in FORTRAN programas. In the examples 
below, the location COMP1 is modified to contain 3.0 and 
4.0 for the real and imaginary parts of a complex 
number, respectively, and the location COMP2 is modified 
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to contain 5.0 as the real part with the imaginary part 
being unchanged. 


MODIFY COMP? '3.0,4.0° 
MODIFY COMP2 ‘5.08 


A fixed-point constant is formed according to the rules 
for writing floating-point constants. However, unless a 
binary scale factor is supplied by the parameter being 
modified, the fractional part is lost. Binary scale 
factors follow the conventions used by the 360 assembler 
language, that is, the scale factor aultiplies the 
constant by the specified power of two. A fixed-point 
parameter may vary in length from one to four bytes. 
Fixed-point constants are right-justified and padded 
with leading zeros. In the examples below, the location 
FIX is modified to the constant 2, and the location FI¥2 
is modified to the constant 32. 


MODIFY FIX *2* 
MODIFY FIX2@S=3 "4 


A floating-point constant is written as a decimal 
number. As an option, a decimal exponent may follow. 
The number may be an integer, a fraction or a mixed 
number. If the length of the parameter is 4 bytes or 
less, the constant is treated as a single-precision 
constant; otherwise, it is treated as a double-precision 
constant. ‘The format of the constant is as follows: 


(1) The number is written as a signed or unsigned 
deciaal value. The decimal point can be placed 
before, within, or after the number. If it is 
omitted, the number is assumed to be an integer. A 
positive number is assumed if an unsigned constant 
is specified. 


(2) The exponent is optional. If specified, it is 
written immediately after the number as En, where 
"n® is an optionally signed decinal value specifying 
the exponent of the factor 10. The value of the 
constant may be in the range of .723700515E+76 to 
«539760 5352-78. If an unsigned exponent is speci- 
fied, a plus sign is assused. No binary scale 
factor say be applied. 


In the following exauples, the parameter XY is aodified 
to 46,415. 


MODIFY XY '86.415° 
MODIFY XY "46415E<3! 
MODIFY XY *¢.46415E2! 
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A hexadecinal constant consists of one or more of the 
hexadecimal digits 0-9 and A=F. Only one hexadecizal 
constant may be specified in the second operand. The 
maximum length of a hexadecimal constant is 256 bytes. 
Constants that contain an even nuaber. of digits are 
translated as one byte per pair of digits. If an odd 
number of digits is specified, the leftmost byte has its 
leftmost four bits filled with zeros, while the right- 
most four bits contain the first digit. Hexadecinaal 
constants are left-justified. There is no padding. In 
the examples below, the locations HEX1 and CHAR are 
modified to the hexadecimal constant C1C2C3c4éc5. 


MODIFY HEX1 *cIc2c3c4cst 
MODIFY CHAR@T=X *'Cic2c3cucs* 


An “instruction" constant consists of a 360 assembler 
mnemonic and a hexadecimal operand of the appropriate 
length. The operand is separated from the mnemonic by 
one or more blanks. No extended aneronics (such as BNM) 
may be used. The length of the instruction constant 
need not agree with the length of the instruction being 
modified. From the saaple program above, the location 
AD is modified to the instruction "S 1,C", 


MODIFY AD 'S 10F014! 


Logical constants are ",TRUE." and ".PALSE.", which are 
converted internally to the fixed-point numbers 1 and 0, 
respectively. If neither ".TRUE." nor “ FALSE." is 
specified, the constant is treated as a character 
String. Logical constants are used primarily in FORTRAN 
programs. In the examples below, the location LOG1 is 
modified to the constant ".TRUE." and the location LOG2 
is modified to the character A. 


MODIFY LOG1 *.TRUE.! 
MODIFY LOG2 ‘A® 


BR packed or zoned decimal constant is written as a 
signed or unsigned decinal value. If the sign is 
omitted, a plus sign is assumed, The existence of a 
deciaal point in no way affects the conversion of a 
decimal constant. In effect, the decimal point is 
ignored. Scaling and exponent modifiers may not be used 
with decimal constants, The maximum length of a deciaal 
constant is 16 bytes. If zoned decimal conversion is 
being performed, each decimal digit is translated into 
one byte, The rightmost byte contains the sign as well 
as the rightmost digit. For packed decimal conversion, 
each pair of decimal digits is packed into one byte. 
The rightmost digit and the sign are translated into the 
rightmost byte. Tf an evwen number of packed decimal 
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digits is specified, the leftmost four bits in the 
leftmost byte are set to zero and the rightmost four 
bits contain the first digit. If the constant requires 
fewer bytes than the length of the parameter, the bits 
of each added byte are set to zero for packed decinal 
conversion. For zoned conversion, the deciaal digit 
zero is placed in each added byte. If the . constant 
requires more bytes than the parameter specifies, no 
modification occurs. 


MODIFY PACK1 '23' 
MODIFY ZONE '=44' 


Not supported. 
V-type adcons are treated the same as A-type adcons. In 
the example below, the location VCON is modified to the 
virtual address 512600. 

MODIFY VCON *512600° 
Yetype adcons are treated as fixed-point decimal con- 
stants whose length depends on the length of the 
parameter being modified. In the exauple below, the 
location YCON is modified to the integer constant 2. 


MODIFY YCON *2* 


All of the conversion types listed with the description of the TYPE 
keyword modifier are supported by the SDS output conversion routines. 


The following 


data: 


Character 
Floating=point 
Fixed-point 


Instruction 
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conventions are used when SDS atteupts to display illegal 


If a hexadeciaal code is encountered which has ‘no 


' character equivalent, a question mark is substituted. 


If the length of the number exceeds 8 bytes, the number 
is printed in hexadecimal format. 


If the length of the number exceeds 16 bytes, the number 
is printed in hexadecimal format. 


‘If the opcode field of an instruction does not corres- 


pond toa machine operation, the instruction is printed 
as two hex digits surrounded by asterisks. The instruc- 
tion is assumed to be 2 bytes in length (RR type). 
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Packed & zoned - If the length of the number exceeds 16 bytes, the number 
is printed in hexadecimal format. 


Current Syszbo] Character 


The current symbol character "**" can be used to represent the last SDS 
parameter specified in a debug command. This is most aseful in SDS command 
sequences such as 


DISPLAY ABC 
MODIFY * ‘1* 


which displays the contents of location ABC and then modifies that location 
to the constant ‘'1'. 


The current symbol character say have a displacement and/or modifiers 
appended to it, but not an index. For example, 


DISPLAY ABC *@T=XaL=8 


displays the contents of location ABC according to its type and length, and 
then displays ABC in hexadecimal format with a length of 8 bytes. 


DISPLAY ABC(10) *+4 
displays the locations ABC (10) and ABC(10)+4. 


For the case of block parameters, the current symbol is the lower-bound 
symbol. For example, 


DISPLAY ALPHA...BETA *@T=X 


causes the range from ALPHA to BETA, to be displayed, after which the 
contents of ALPHA in hexadecimimal format, are also displayed. 


Note that many debug commands refer to SDS parameters and, therefore, 
change the value of the current symbol character. Hence, the user should be 
aware of the value that the current symbol character is representing. 


PROGRAM RETURNS s DYNAMIC LOADING, AND INTERRUPT PROCESSING 


Whenever the user's program returns to the systerm by calling subroutines 
SYSTEM, MTS, MTSCHD, or ERROR, SDS intercepts the return and returns control 
to debug command aode. For a return to the system or a call to SYSTEM, the 
program may not be continued with the CONTINUE command; for the other 
subroutine calls, the program may be continued. For a call to MTSCMD, the 
command specified will have been executed. 
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Whenever the user's program dynamically loads another section via a call 
to the subroutines LINK, LOAD, or XCTL, SDS intercepts the call and returns 
control to debug command mode. The sections specified in the subroutine 
call have been loaded at this point, but not entered. The user may then set 
breakpoints, if he desires, before continuing the program. The interception 
of calls to LINK, LOAD, or XCTL may be enabled by the debug command 


SET XFR=ON 


Whenever a program interrupt, an attention interrupt, a timer interrupt, 
or an I/O error occurs during the execution of the program, SDS normally 
intercepts the error condition and returns control to debug commmand sode. 


In the case of a program interrupt, the location of the instruction 
causing the interrupt is printed. Por an isprecise interrupt (protection 
exception), an indication that the interrupt was imprecise is also printed. 
The user's program may be restarted by the CONTINUE command, unless the 
interrupt was imprecise, in which case, the GOTO or RUN comaand aust be 
used. 


In the case of an attention interrupt, the location at which the 
interrupt occurred is printed. The user's program may be restarted by the 
CONTINUE command. 


In the event that the user's prograsa has calied the system subroutines 
PGETTRP or ATTNTRP, SDS may or may not regain control depending on what the 
user's interrupt routines do. However, the user may disable his own 
interrupt routines by entering the debug command 


SET PGNT=OFF ATTN=OFF 


When the interrupt is taken, control is returned immediately to SDS. If the 
user restarts his program with the CONTINUE command, execution is restarted 
at the instruction at which the interrupt was taken. The user's interrupt 
routines are not called. Norwal interrupt processing may be resused by 
setting the PGNT or ATTN options ON, Note that all FORTRAN prograas 
automatically call PGNTTRP to allow the FORTRAN library to process progran 
interrupts. For SDS to process program interrupts in a FORTRAN progran, 
PGNT must be set OFF. 


In the case of a timer interrupt, the location at which the interrupt 
occurred is printed. The exceeding of a local time limit is the only type 
of timer interrupt which causes control to be returned to debug mode unless 
the exit routine returns to the systen. 


In the case of an 1/0 interrupt, a system error message (if any) is 
printed. If the user has suppressed the intercept of the I/O error either 
by calling the subroutines SETIOERR or SIOERR or by specifying the ERRRTN 
I/O sodifier on the I/0 call, control is not returned to debug node. 


If the user's program causes an MTS program interrupt (often caused by 


passing an illegal parameter to an 1/0 subroutine), control is returned to 
debug mode with the sessage that execution has been prematurely interrupted. 
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Whenever a program interrupt, an attention interrupt, an I/O interrupt, a 
timer interrupt, or an intercepted call to LINK, LOAD, or XCTL occurs, SDS 
changes its input source to read from *MSOURCE* and its output sink to write 
on *MSINK*. 


BREAKPOINT PROCESSING 


SDS provides the user with the facility of setting several different 
types of breakpoints in strategic locations in his program. When encoun- 
tered during program execution, these breakpoints cause SDS to assume 
control of the program and take a certain course of action. Each breakpoint 
inserted in the user's program is a halfword code which replaces the 
contents of the location at which it is inserted and which causes a special 
program interrupt and returns control to SDS. The halfword portion of the 
instruction that is replaced by the breakpoint code is saved for later 
execution when the program resumes execution, The different types of 
breakpoints that are currently available are described below. 


Global Breakpoints 


A global breakpoint is used to return control to debug command mode. The 
user may then enter any debug ccmmand. Global breakpoints are set by the 
BREAK command. For example, 


BREAK AD 


sets a simple breakpoint at location AD. For further details of global 
breakpoint processing, see the description of the BREAK command below. 


Local_Breakpoints 


A local breakpoint is used to return control to debug command aode. 
Local breakpoints are set by the parameters to the RUN and CONTINUE 
commands, or the second and successive parameters to the GOTO command. For 
exanple, 


RUN AD 


sets a local breakpoint at location AD and then initiates execution of the 
user's program at the entry point. If more than one local breakpoint is 
set, the first one encountered returns control to debug command mode. Local 
breakpoints are in effect oply for the duration of the current command that 
set them; they are automatically erased before the user enters his next 
command. 
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At=points 


An at-point is used to cause SDS to process a list of prestored commands. 
This list of prestored commands is set up by the AT command. (See the 
description of the AT command.) 


Breakpoints may not be set at an instruction which is the object of an 
execute instruction, at an instruction which is modified by the program, or 
at an instruction preceding a BPI instruction. For execute instructions, 
the breakpoint should be set at the execute instruction itself. If the 
location specified is not halfword-aligned, the breakpoint is not set. A 
warning is issued if the user sets a breakpoint in a data iten. 


THE_SDS_SIMULATOR 


A prograrg simulator is provided by SDS to allow the user to step through 
his program one or sore instructions at a time. All instructions that are 
stepped through are simulated by SDS instead of executing normally. 


The simulator is invoked by the STEP command specifying the nuaber of 
instructions to be stepped, for exagple, 


STEP 3 


causes the next three instructions to be stepped. If no step count is 
given, a step of 1 is assumed. Stepping starts with the current address 
contained in the PSW. Upon completion of the stepping, control is returned 
to debug command node. 


If an abnormal condition occurs during stepping, the stepping is 
terminated at the current instruction and control returns to debug command 
node. If the prograa branches to a legal low-core syabol such as SCARDS or 
SPRINT, the routine is executed instead of being siasulated and stepping 
resumes upon the return from that routine. The execution of the routine 
does not count as a step. If the programa branches to an address less than 
300000 which does not correspond to a legal low=core sysabol, stepping is 
terminated and a warning message is printed. The user may restart the 
program with either a CONTINUE or a GOTO command. 


If a program interrupt or an attention interrupt occurs and the user has 
specified an exit routine via the PGNTTRP or ATTNTRP subroutines, these 
routines are also simulated until the specified stepping count is exhausted. 
This may be overridden by the PGNT and ATTN options of the SET command. 


FORTRAN users should note that the STEP command specifies 
instructions in the count. To step a specified number of FORTRAN 
instructions, the CONTINUE command should be used specifying temporary 
breakpoints. 
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CONTROL SECTION PROCESSIN 


When a program of one or more sodules! is initially loaded by SDs, the 


control sections, common sections, and dummy control sections of the modules | 


are entered into the SDS map in the order in which they appear in the load 
module(s). These modules comprise a single map control block within the SDS 
map. If, during execution, the program calls the loader to load amore 
modules, these also are processed by SDS and entered into the SDS map ina 
new map control block. 


A separate map control block is created for each call to the loader. 
Hence, the sections that comprise each map control block have a unique 
storage index number. . 


The first time a control section name appears in the SDS map, it is 
assigned a generation number of 1. If a control section is loaded which has 
the same name as a previously processed control section in an earlier map 
control block, that section is assigned a new generation number one greater 
than the last previous generation number used for a section by that name; 
hence, for each subsequent occurrence of a control section for a given nane, 
there is assigned to it a unique generation number. This generation nuaber 
can be used via the GEN keyword modifier to distinguish between the 
different occurrences of control sections with the same name. Dummy control 
sections (dsects) do not have generation nuabers assigned to them. 


Initially, the first module in the SDS map becomes the current module and 
the remaining modules are globally opened for referencing. If SDS cannot 
locate a given symbol in the current module, the remaining modules are 
searched. If the symbol is located, sps searches through all remaining 
modules for a match to determine whether or not the symbol is multiply 
defined. A warning message is printed for a multiply defined symbol and the 
first definition is used. If a relative address can be located in the 
current module, no further searching occurs. 


The order of searching through the SDS map for a symbol is as follows: 


(1) If the symbol is a predefined symbol, the search terminates 
inmediately. 

(2) If only one module of the map is open (see below), only that nodule 
is searched. The search covers all control sections and defined 
dsects of that module. 

(3) If the entire map is open, the most recent generation of the first 
section is searched. If the symbol is not found, the next oldest 
generation is searched. If the generation string does not contain 
the symbol, the most recent generation of the next section is 
searched. If no match is found in any generations of sections 
loaded in the first map control block, the sections in the next map 


1A module is defined as a sequence of load records ap to and including an 
END record. For FORTRAN programs, each main program and subroutine 
produces a separate object module. 
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control block are searched according to the same algoritha. No 
section is searched sore than once. If a aatch is found in any 
section, the remainder of the map is searched for a duplicate 
symbol. If none is found, the search terminates; otherwise a 
warning is printed and the first match is used. If a match is found 
in an undefined dsect, the search continues looking for a match ina 
defined section. If such a match is found, and no futher duplica- 
tion exists, the search is terminated with no warning message. 


The CSECT command provides a means of specifying a new current sodule. 
The module containing the section nased by the command becomes the new 
current asodule and the remaining modules are closed; that is, checking for 
multiply defined symbols is suppressed and, if a symbol cannot be located in 
the current nodule, no further searching takes place. Tf the section 
specified is a control section or dsect, all control sections and dsects in 
that module are open for searching; if the section specified is a common 
section, only that comsgon section is open for searching. For example, the 
compand 


CSECT SUBR 


specifies the nodule containing the section SUBR as the current nodule, if 
the CSECT command specifies a common section, only that common section is 
taken as the current module; all other symbols that saay be in the sane 
module are ignored. If the comsand 


CSECT i 


is entered, where i is an unsigned decimal integer, the aodule containing 
the ith blank=naaged control section in the SDS map becomes the current 
sodule. This is the only way to refer to blank-nared (private) control 
sections in the map. A blank-named common section say be referred to by the 
blank-name comaon symbol BLANK. 


If the conmand 
CSECT * 


is entered, the first module in the SDS map again becomes the current aodule 
and the remaining modules are opened. The open-map character "“*" may he 
changed by the SET command. 


Object modules composed of asultiple assemblies may have name conflicts 
between control sections, common sections and dsects. SDS observes the 
following conventions when such conflicts occur within a single sap control 
block: 


Situation Action Taken 
A CSECT has the same nane The original CSECT is retained 
as a previously defined and the duplicate CSECT is 
CSECT. ignored, unless it is a blank- 


narmed CSECT. 
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A CSECT has the same name 
as a previously defined 
COMMON section. 


A CSECT has the same narze 
as a previously defined 
DSECT. 


A COMMON section has the 
same name as a previously 
defined CSECT. 


A COMMON section has the 
same name as a previously 
defined COMMON section. 


A COMMON section has the 
same name as a previously 
defined DSECT. 


A DSECT has the same name 
as a previously defined 
CSECT. 


A DSECT has the same nage 
as a previously defined 
COMMON section. 


A DSECT has the same name 
as a previously defined 
DSECT in the same nodule. 


A DSECT has the same nane 
as a previously defined 
DSECT in a different 
nodule. 
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The symbols of the CSECT are 
merged with the symbols of the 
COMMON section. 


Both the CSECT and the DSECT are 
retained. 


The CSECT is marked as a COMMON 
section in the SDS map, and the 
symbols in the COMMON section are 
merged with the symbols of the 
CSECT. 


The original COMMON section is 
retained and the symbols of each 


are merged. 


Both the DSECT and the COMMON 
section are retained. 


Both the DSECT and the CSECT are 
retained. 


Both the DSECT and the COMMON 
section are retained. 


The original DSECT is retained 
and the symbols of each are 
merged. 


Both DSECTs are retained. 


Systea 


SDS provides a terse mode of operation which eliminates or shortens 
and diagnostic messa 


of the confirsation 
activated by the command 


SET TERSE=ON 


ma hy 
ges printed by SDS. This mode is 
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and is deactivated by the cosnand 


SET TERSE=OFF 
| The following messages are eliminated in terse node: 


(1) READY. This message is often printed when SDS is ready to accept a 
‘command. 

(2) DONE. his message is often printed after SDS has taken some action 
such as setting or restoring a breakpoint. 

(3) Verification by the MODIFY command. The MODIFY command normally 
verifies the modificaticn by printing both the old and new values of 
the location being modified. 


The following sessages are shortened in terse mode: 
(1) The breakpoint and at-pcint interrupt messages give only the address 
of interruption and do not identify the type of interruption. 


(2) The call to SYSTEM, FRROR, MTS, and MTSCMD messages do not give the 
GRT4 return address. 


| Automatic Error Dusping in Batch 


An automatic error duaping facility similar to that provided by the MTS 
SERROXDUMP command is provided for batch users. In the event of an error 
condition occurring during the execution of the program, a symbolic dump of 
the program is given. This duap includes the PSW, the general and 
floating-point registers, and all of the data storage locations in the 
programs. Instructions and other areas not covered by the symbol table are 
excluded. This facility may be activated by the command sequence 


S$SET DEBUG=ON 
$SDS SET ERRORDUAP=ON 
SRUN PDnane 
where ?Dname is the file containing the user program to be executed. Note 
that the MTS SRUN command has been given instead of the S$DEBUG command. The 
error-dusap facility say be deactivated by the command 
SSET DEBUG=OFF 
or 
$SDS SET ERRORDUMP=O0FF 
Terminal users may obtain a symbolic dump by the DUMP debug command. A 


saaple of the syabolic dump format is given in the section "Introduction to 
Debug Bode for FORTRAN". 


330 Debug Hode 


MTS Volume 1: MTS -= The Systenr 


April 1974 


Using SDS_ Without a Loaded Program 


Several of the debug commands may be used successfully even if SDS has 
not processed the loaded program or if there is no currently loaded progran. 
For example, the user may use the output conversion facilities of SDS to 
display selected locations of virtual memory, for example, the debug command 


DISPLAY 516260@T=C@L=32 


displays in character format the 32 bytes starting at location 516260, if it 
is a valid virtual address. The input conversion facilities may be used to 
modify selected storage. For example, the debug command 


MODIFY 5162¢€0@T=C@L=8 'ABCDABCD® 


causes the 8 bytes starting at location 516260 to be modified to the 
character string ABCDABCD. 


The above command may be given from MTS command mode in the form of a 
"one=shot" $SDS command: 


$SDS MODIFY 516260@T=C@L=8 "ABCDABCD®* 


After the one-shot command is executed, control is returned to MTS command 
node. 


initializing, Resetting, and Terminating SDS Processing 


When SDS is initialized, an area of system storage is assigned to SDS and 
all of the default SDS options are set. SDS is initialized under any of the 
following conditions: 


(1) If DEBUG=OFF is specified, (the default), SDS is initialized with the 
first SDEBUG or $SDS ccmmand in the job or after SDS has_ been 
terminated (see below). 

(2) If S$SET DEBUG=ON is specified, SDS is initialized with the first 
SDEBUG, SRUN, SLOAD, SRESTART, SSTART, or $SDS command in the job or 
after SDS has been terminated. 


When SDS is reset, all of the loaded program symbol table information (if 
any) is released and certain SDS tables are released, The basic SDS work 
storage remains and the SDS SET options remain in effect (except for the 
INPUT, OUTPUT, ENTRY, PAR, and logical I/70 unit assignments). Input 
commands are read from *SOURCE* and output is written on *SINK*,. SDS is 
reset under any of the following conditions: 


(1) During initialization (see above). 

(2) With each SDEBUG, S$RUN, and S$LOAD command if $SET DEBUG=ON is 
specified. 

(3) With each SDEBUG command if SSET DEBUG=OFF is specified. 
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When SDS is terminated, all of the loaded program sysbol table inforsa- 
tion (if any) is released and the basic SDS work storage is released. SDS 
is terminated under any of the following conditions: 


(1) The STOP debug coamand is given. 

(2) The $SET DEBUG=OFF command is given. 

(3) The SUNLOAD CLS=SDS command is given. 

(4) A SRON or $LOAD command is given (if S$SET DEBUG=OFF is specified). 


If a program interrupt occurs in SDS and SDS is not in the process of 
modifying any of its syabol table information storage areas, SDS returns to 
debug command mode and prompts the user for permission to continue. If the 
user replies affirmatively, another debug command say be given; otherwise, 
SDS error returns to MTS cosmand sode. Tf spS is in the process of 
modifying the symbol table, an SDS error return to MTS occurs immediately. 


DEBUG CONMAND DEFINITIONS 


On the following page is a list of the debug commands available for SDS. 
Parameters for each command aay be separated by commas or blanks. Some of 
the parameter terms used are: 


(1) simple parameters -- these are parameters of the form S(i)+tj. 


(2) parameters <- these are either siuple parameters or paraagzeters of 
the foram 5 (1) +4. eS (i) 43. 


The following notation conventions are used in the prototypes of the 
commands: 


lower case = represents a generic type which is to be replaced by an 
item supplied by the user. 

upper case - indicates material to be repeated verbatim in the command. 

brackets [J] - indicate that saterial within the brackets is optional. 

braces {} - indicate that the material within the braces represents 

choices, from which exactly one aust be _ selected. the 

choices are separated by vertical bars. 

dots «ee ~ indicate that the preceding syntactic unit(s) may he 
repeated. 

underlining - indicates the minimum abbreviated form of the command or 
parameter. Longer abbreviations are accepted. 


Note that for descriptions of the ATINTRP, INPUT, LENGTH, OUTPUT, PGNTTRP, 
PREFIX, RF, SCALE, TERSE, and TYPE commands, see the appropriate SET command 
options. These commands are seEsenentec as individual commands, but are not 
individually documented. 
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Summary of Debug Command Prototypes 


ALTER 
AT 
ATINTRP 
ATTRIBUTE 
BRFAK 
CLEAN 
COMMENT 
CONTINUE 
CSECT 
DISPLAY 
DROP 

DUMP 

END 

GOTO 
HEXDISPLAY 
IGNORE 
INPUT 
LENGTH 
LIST 

MAP 
MODIFY 
MTS 
QUTPOT 
PGNTTRP 
PREFIX 
QUALIFY 
RESET 
RESTORE 


Parameters 


sinple~ parameter 
simple- parameter 
{ON(OFF} 

simple=- parameter 
simple-parameter ... 

{ BREAKPOINTS J(AT*POINTS 

{text ] 

(simple-parameter ...] 

{section ji|*} 

parameter ... 
{dsect-name{sinple-parameter} ... 
{ (PSWIGRS|FRS|section} ... ] 


simple~-parameter {simple=parameter ...] 
parameter ... 

breakpoint-label {i|simple-parameter} 
FDname 

i 

{ BREAKPOINTS ][ AT=POINTS } 

{ (FOLLIDSECT} ] 

Simple~pararmeter {'value ...'|simple-parameter} 
(command J 

FDname 

{ON |OFF} 

character 

Simple-parameter ... 


{'value ...'{sisple-paraneter} 


{simple-parameter ...] 
hexadecimal-constant 
(simple=parameter ...] 

i 

{ {section| address1...address2|*} ‘value' ] 
keyword-parameter ... 


Ci] 


Simple-parameter ... 
{ON{ OFF} 

code 

dsect=-name address 
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ALTER 
DEBUG COMMAND DESCRIPTION 
Prototype: ALTER simple-parazeter {‘value ...‘'{simple-parameter} 
Action: The ALTER command is identical to the MODIFY command. See 


the description cf the MODIFY command. 
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Prototype: 


Action: 


Comments: 
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AT 
DEBUG COMMAND DESCRIPTION 


AT simple-parameter ... 


(1) An at-epoint is inserted at each location specified in the 
parameter list. The at=-point code is an X'0002' which 
replaces the instruction at the location specified; the 
instruction replaced is saved for later execution when 
executicn of the program is resumed. 


(2) SDS enters into at-rinsertion mode (indicated by the 
at~-prefix character "&"). All the commands entered 
during at-insertion mode are saved in a command list for 
later processing. If the user enters a null command line 
during at-insertion mode, the previously-entered conwand 
is deleted from the list of saved commands. When an 
end-of-file or END command is entered, SDS resumes normal 
command processing. If another AT command is entered 
during ateinsertion mode, the first command list is 
terminated and a second command list is started. 


When an at=point is encountered during the execution of the 
user's program, each of the commands in the command list for 
that at=-point is executed in sequence. When the last 
deferred command has been executed, control returns to the 
user's program which resumes normal execution. If control is 
to be returned to debug command sode rather than to the 
progran, the SDS command should appear immediately before the 
END command since the SDS command terminates the processing 
of the command list. An abnormal condition also terminates 
command list processing. 


At-points are automatically announced if the command list 
causes an output message to be generated (for example, the 
output from the DISPLAY command), or if there is no command 
list for the atepoint. The COMMENT comamand may be used to 
cause comments or announcements of at-points when no output 
messages would otherwise be generated. 


An atepoint may not be set at an instruction which is the 
object of an execute instruction, at an instruction which is 
modified by the program, or at an instruction preceding a BPI 
instruction. For an execute instruction, the at-point should 
be set at the execute instruction itself. If the location 
specified is not halfword-aligned, the at-point is not set, 
A warning is issued if the user sets an at-point in a data 
item. 
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At-points may be removed by either the RESTORE or the CLEAN 
commands. 


AT LOOP 

DISPLAY XVAL YVAL N 

DISPLAY GRY FRO 

END ; 
In the first example, each time location LOOP is reached, the 
current values of XVAL, YVAL, N, general register 1 and 
floating-point register 0 are displayed. 


AT BOO@R 509056 
DISPLAY GRS 

AT LOC2 

MODIFY Fz *0000° 
DISPLAY Y(1)... (6) 
sps 

END 


In the second example, each time the relative location £00 or 
the absolute location 504056 is reached, the general regis=- 
ters are displayed. Each time location LOC2 is reached, 
location PZ is zeroed and the first six elements of the Y 


array are displayed; control then returns to debug command 


node rather than to the progran. 


AT IS#5 

DISPLAY A(1,1).«+ (1,19) 
CONTINUE IS#8 

DISPLAY A(1,1).-.- (1,10) 
END 


In the third example, the first ten elements of the FORTRAN 
array A are displayed at location IS#5 and execution is 
resumed by the CONTINUE command specifying a local breakpoint 
at IS#8. When the local breakpoint is encountered at IS#8, 
the array is displayed again; execution is then resumed since 
the at-point coajsand list processing is concluded. 
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ATTRIBUT 


DEBUG COMMAND DESCRIPTION 


Prototype: ATTRIBUTE siaple-parameter ... 


Action: The attributes for each parameter in the list are displayed; 
these include: 


the loaded absolute address, 

the relative address, 

the section nane, 

the section generation number (if different from one), 
the type, 

the length, 

the duplication factor (if different from one), 

the scale factor (if different from zero), and 

the dimension number (if a FORTRAN array). 


The one-character codes for the type are defined with the 
description of the TYPE keyword modifier. 


Example: ATTRIBUTE GAMMA 
The attributes of GAMMA are displayed as 


GAMMA: 
LA=514020 RA=000020 SECTION=PROG TYPE=F LEN=4 DUP=20 
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BREAK 
DEBUG COMMAND DESCRIPTION 


BREAK simple-parameter ... 


A global breakpoint is inserted at each location specified in 
the parameter list. The breakpoint code is an x'0001* which 
replaces the instruction at the location specified; the 
instruction replaced is saved for later execution when 
execution of the program is resused. 


When the progras being debugged atterapts to execute the 
instruction at the breakpoint, control is returned to SDS 
which announces the location of the breakpoint and proapts 
for its next command. The instruction at the breakpoint has 
not yet been executed. The status of the program is 
preserved and may be examined and modified with the appropri- 
ate coamands., The program may be restarted with the CONTINUE 
or STEP commands which execute the instruction at the 
breakpoint and resume normal sequencing. To restart at some 
other point, the GOTO command may be used. 


Breakpoints may be removed with either the RESTORE or the 
CLEAN commands. 


A breakpoint may not be set at an instruction which is the 
object of an execute instruction, at an instruction which is 
modified by the program, or at an instruction preceding a BPI 
instruction. For an execute instruction, the breakpoint 
should be set at the execute instruction itself. If the 
location specified is not halfword-aligned, the breakpoint is 
not set. A warning is issued if the user sets a breakpoint 
in a data iten. 


For FORTRAN prograas, the user say set breakpoints by 
specifying the external (user-defined) or internal (source 
listing) statement nuabers. The "#" sust be used to prefix 
the external statement number, for exanple, 


BREAK #10 


and "TS#° aust be used to prefix the internal statement 


number, for exaaple, 
BREAK IS#10 


Note that only those statement numbers which define execut= 
able FORTRAN statements may be used. All others, such 45 
DIMENSION, DATA, COMMON, SUBROUTINE, FUNCTION, ENTRY, EQUIVA- 
LENCE, or FORMAT statements are undefined. 
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Example: BREAK LOOP 206 513100 


Global breakpoints are set at the symbolic location LOOP, the 
relative location 206, and the absolute location 503100. 
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CLEAN 
DEBUG COMMAND DESCRIPTION 
Prototype: GLEAN (BREAKPOINTS ][ AT-POINTS ] 
Action: Tf no parameter is specified, all breakpoints set by the 


BREAK command and all at-points set by the AT command are 
deleted. If a parameter is given, then only the specified 
type is deleted. 

Example: CLEAN A 


All at-points are removed from the progran. 
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Prototype: 


Action: 


Example: 


MTS Volume 1: MTS -- The Systen 


| COMMENT 


DEBUG COMMAND DESCRIPTION 


COMMENT [text] 


If the user has entered the coamand in at-insertion node, the 
comment is printed when the at-point command list is 
processed. 


If the user is in debug command mode, no action is taken. 


AT LOOP 

COMMENT SKIP 2 INSTRUCTIONS AT LOOP 
GOTO LOOP (3). 

END 


At the location LOOP, the comment "SKIP 2 INSTRUCTIONS AT 
LOOP" is printed; then, execution resumes at location 
LOOP (3). 
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CONTINUE 
DEBUG COMMAND DESCSIPTION 


CONTINUE [simple-parameter ...] 


Execution of the progran is resuaed from the point of the 
last interrupt. If a breakpoint was encountered, execution 
begins with the instruction at the breakpoint. If an 
attention interrupt or program interrupt had been taken, 
execution begins at the. location specified by the PSW. In 
the event of an imprecise progras interrupt, a GOTO or a_ RUN 
comaand sust be used to restart the user's prograng. 


Tf a simple parameter is specified, a local breakpoint is set 
at the location specified. This breakpoint code is an 
X*0004' which replaces the instruction, When the program 
encounters a -lecal breakpoint, control is returned to debug 
command gode. Local breakpoints are in effect only for the 
duration of the command, and are automatically erased before 
the user enters his next command. 


The CONTINUE command may be used to initiate execution of the 
prograg if the initial values of the registers and/or PSW 
have been aodified. 

CONTINUE LOC2 


A local breakpoint is set at location LOC2 and execution of 
the program is resuned. 


342 CONTENDE Debag Copamand 


April 1974 


Prototype: 


Actions: 


Comment: 


Examples: 
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DEBUG COMMAND DESCRIPTION 


CSECT {section|i{*} 


If section is given, the module containing the section named 
becomes the new current module and the remaining modules are 
closed; that is, checking for multiply defined symbols is 
suppressed, and, if a symboi cannot be located in the current 
module no further searching takes place. If section speci- 
fies a control section or dsect, all control sections and 
defined dsects in that module are.open for searching; if 
section specifies a common section, only that common section 
is open for searching. 


If i is given, the module containing the ith blank-nanmed 
control section loaded becomes the current module and the 
remaining modules are closed (see "Control Section Proces- 
sing" above). : 

If the open-map character "*" is given, the first nodule 
loaded again becomes the current module and the remaining 
modules are opened. 


To specify a module containing a dsect as the current module, 
section must be specified as 


dsecta@C=csect 
where "“csect" is the name of the control section with which 
the dsect was assembled. The dsect must be previously 
defined with a USING command. 
CSECT PROG 


The module containing the section PROG becomes the current 
module. 


CSECT DAREA@C=SUBR 


The module containing the dsect DAREA in the section SUBR 
becomes the current nodule. 
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DISPLAY 
DEBUG COMMAND DESCRIPTION 
Prototype: DISPLAY parameter ... 
action: Each siaple or block parameter (or element in the range of a 


block parargeter) is converted according to its type and 
length and printed along with a one character code which 
indicates the ‘parameter's type. The type codes are defined 
with the description of the TYPE keyword sodifer. 


If the type and length attributes of a parameter are unknown, 
or if a parameter specifies an address which is incorrectly 
aliqned with respect to its type, the contents of the byte 
specified by the parameter, and the contents of the next 
three bytes, are printed in hexadecimal format. 


fo display a large block of storage, use the DUMP or 
HEXDISPLAY commands if possible for economy. 


Exaaple: DISPLAY ALPHA 


The location ALPHA is displayed according to its type and 
length attributes. 
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Prototype: 


Action: 


Example: 
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DROP 
DEBUG COMMAND DESCRIPTION 


DROP {dsect-nane|siaple-parameter} ... 


If dsectengame is specified, that dsect loses its addressabi- 
lity. (See the description of the USING command.) 


If simple~parameter specifies a general register, all dsects 
covered by that register are no longer addressable by SDS 
(that is, symbols and relative addresses within that dsect 
cannot be accessed). Tf simple-paraseter specifies a loca- 
tion, all dsects based at the virtual address corresponding 
to that location lose their addressability. 


Tf the parameter may be interpreted both as a dsect name and 
as a syabol, it is assumed to be a dsect name. 


DROP GR1 


The dsects covered by GR1 are released and are no longer 
addressable. 
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DURE 
DEBUG COMMAND DESCRIPTION 


DUMP [ (PSWIGRS|FRS|section} ...] 


A symbolic deap of the sections specified is given. The dump 
includes only the variable storage of the section; instruce- 
tions and areas not covered by the symbol table are excluded. 


For each iter dumped, the relative address, the symbolic 
name, the data type, the converted value, and the hex value 
(if the data type is not X) is duaped. 


If PswW is specified, the hex and syarabolic address forms are 
given. 


If GRS is specified, the general registers are dumped in hex, 
fixed-point deciaal, and symbolic address format. 


If FRS is specified, the floating-point registers are dumped 
in hex and floating-point decinmal format. 


If no parameter is specified, the PSW, the registers, and all 
sections are dumped. 


Since the output froma this command may be extensive, terminal 
users should set the output device to a file or *PRINT* via 
the SET OUTPUT=FDname command. 


A sample of the syabolic duap format is giwen in the section 
"Introduction to Debug Mode for FORTRAN". 


For batch users, an automatic syabolic dump may be obtained 
in the event of an abnormal program termination via the SET 
ERRORDUBP*ON debug command. This facility is similar to the 
SERRORDUMP command in #TS command mode which produces a 
hexadeciaal duap of a program in the event of an abnormal 
prograrg termination. 


SET OUTPUT=*PRINT* 
DUMP 


Kh symbolic dump of the PSW, the registers, and all loaded 
sections are produced on *PRINT*,. 
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Prototype: 


Action: 


Example: 
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END 


DEBUG COMMAND DESCRIPTION 


END 

If the user is in at-insertion mode, the current sequence of 
commands being entered into command list associated with the 
at-point is terminated, and control is returned to debug 
command mode, 


TF the user is in debug command mode, no action is taken. 
AT LOOP 
DISPLAY GR1 
END 
The command list for the atepoint at location LOOP is 


terminated by the END command and control is returned to 
debug command mode. 
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' DEBUG COMMAND DESCRIPTION 


GOTO simple=parameter [simple-parameter ...] 

Execution of the program is resumed at the location specified 
by simple-parameter. The parameter must specify a halfword- 
aligned address. 


Tf a second simple-parameter is specified, a local breakpoint 
is set at the location specified. This breakpoint code is an 
X°0004" which replaces the instruction. When the progran 
encounters a local breakpoint, control is returned to debug 
command mode. Local breakpoints are in effect only for the 
duration of the command, and are automatically erased before 
the user enters his next command. 


The GOTO command may be used to initiate the execution of the 
program if a different entry point is desired. 


GOTO LOC1 LCC2 


A local breakpoint is set at location LOC2 and execution of 
the program is resumed at location LOC1. 
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Example: 
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HEXDISPLAY 
DEBUG COMMAND DESCRIPTION 


HEXDISPLAY parameter ... 
Each simple or block parameter in the list is dumped in the 
hexadecimal format used by the SDUMP subroutine. (See the 
description of the SDUMP subroutine in Volume 3.) 

HEXDISPLAY 5002a00...5002EC 


The 96 bytes starting at location 5002A0 are dumped in 
hexadecimal format. 
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ZGNORE 
DEBUG COMMAND DESCRIPTION 


IGNORE breakpoint=-label {i|simple=parameter} 


Ordinarily, when control reaches a global breakpoint or an 
at-point in the program, execution is interrupted and control 
returns to SDS. The IGNORE command provides a means of 
suppressing this interruption each time control reaches the 
breakpoint, for a total of i times, where i is either a 
deciaal integer or the contents of the location specified by 
a simple parageter. The ji+ist time control reaches the 
breakpoint, the interruption is taken as usual. 


If a simple parameter is specified, the parameter's type may 
be fixed-point (fullword or halfword), floating-point (long 
or short), or hexadecimal (4 bytes or less). A simple 
parameter that is in the form of a relative address must have 
the @R modifier appended. 
The ignore count may not be greater than 65535. 

IGNORE LOOP 10 


The breakpoint at the location LOOP is ignored 10 times. 
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Action: 


Example: 
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List 
DEBUG COMMAND DESCRIPTION 


LIST (BREAKPOINTS ]{ AT=POINTS } 


If BREAKPOINTS is specified, a list of the currently set 
breakpoints created by the BREAK command is. produced. If 
AT-POINTS is specified, a list of the currently set at-points 
created by the AT command is produced. If neither BREAK= 
POINTS nor AT“POINTS is specified, all currently set breake 
points and at-points are listed. In all cases, the rmost 
recently set breakpoints or at-points are listed first. 


LIST A 


A listing of all the currently set at=-points is produced. 
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MAP 


DEBUG COMMAND DESCRIPTION 


MAP [ (FULL|DSECT} ] 


A loader-like map is produced, listing each control section 
and comgaon section in the user's program. The map includes 
the section name, section type, the section length, the 
loaded address, the relocation factor, and the storage index 
nuaber. If the storage index number is omitted, then it is 
the same as the storage index number of the previous section. 


Blank=naned (private) control sections are specified by 
unsigned decimal integers assigned according to their order 
in the SDS map. This integer is the only way to refer toa 
blank-named control section. A blank-named common section is 
specified in the map as a blank syabol. The blank=-name 
comaon symbol (initially BLANK) is used to refer toa 
blank-named common section. 


If the FULL parameter is specified, the map includes all 
dsects. and library loaded sections. If the dsect is unde- 
fined, the address field is blank; if the dsect is defined, 
the address field contains the current address definition for 
that dsect. Addresses 000001 through O0000F are used to 
indicate that the dsect is defined by the current contents of 
GR1 through GRF (GR15), respectively. 


If the DSECT parameter is specified, the map only includes 
the currently defined dsects; control sections, common sec- 
tions, and undefined dsects are omitted. 


The symbols used for the map type are: 


sD control section definition 

CM common section definition 

DS dsect definition 

LSD library control section definition 
LCM library common section defintion 
LDS library dsect definition 

MAP FOLL 


A full map is printed as follows: 


NAME TYPE LENGTH ADDRESS RELOC Si# 
MAIN SD 000268 5034c8 5034c8 0080 
com1 Cm 000070 503730 503730 

DSEC1 cS O000F4 


é 
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COM2 
SUBR 
DSEC2 
SQRT 


CM 
SD 
cs 
LSD 


000020 
000228 
00002C 
090032 
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5037A0 
5037C0 
000009 
5039F0 


503740 
5037C0 


5039F0 
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MODIFY 
DEBUG COMMAND DESCRIPTION 


MODIFY simple-parameter {'value ...‘'| simple-parameter} 


The first parameter specifies the locations that are to he 
modified and the second parameter specifies the values to be 
used for the modification. 


value...  ##specifies a list of one or more constants 
delimited by blanks or commas. The entire list is enclosed 
in primes. The constant or list of constants is placed in 
the location specified by the parameter. The constants are 
converted according to the type and length attributes of the 
first parameter. No modifiers may be appended to the 
constants themselves. 


If the second parameter specifies a location, then the 
hexadecimal contents of that location is used for the 
modification. The length used is the length attribute of the 
first parameter. 


The use of type, length and scale affects only the first 
operand in cases where a list is used. 


When the modifier is a hexadecimal constant, the length of 
the constant, rather than the length of the parameter being 
modified, is used when SDS makes the modification. 


If type, length or-scale qualifiers are used, each modifier 
is converted according to the resulting type, length and 
scale attributes of the parameter being modified. (Since 
instructions define their own length, the length of type 1 
parameters is ignored.) 


Verification of the sodification is given by printing both 
the old value and the new value of the location modified. 
Verification may be suppressed by entering terse mode (see 
the TERSE option in the SET command description). 

MODIFY BETA (3) *87 96 84 2° 


The first four locations starting with BETA(3) are modified 


to the constants 87, 96, 84, and 2, respectively. 


MODIFY DELTA@T=xX *'0000003E' 


DELTA is modified in hexadecimal format to the constant 
GCODD003E. 
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MODIFY GR1 GR3 


The contents of general register 3 are copied to general 
register 1. GR3 retains its original contents. 
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ars 
DEBUG COMMAND DESCRIPTION 
Prototype: MTS [optional-conmand j 
Action: Control returns to MTS command mode. The MTS command SDS 


returns control to debug command node, from which the user 
can then resume debugging his program. An optional MTS 
command may be specified, which is executed in MTS command 
mode before control is given to the user. 


Exaaple: In the following example, the SDS user displays the general 
registers, returns to MTS, dumps his storage into a scratch 
file, and returns to SDS, which solicits for its next 
command. The status of the program being checked out has not 
changed and is restarted with the CONTINUE command. 


DISPLAY GRS 
MTS 

SDUMP ON -TEMP 
$SDS 

CONTINUE 
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QUALIFY 
DEBUG COMMAND DESCRIPTION 


QUALIFY simple-parameter ... 

The type and scale attributes of a symbol are changed 
according to the type and scale modifiers appended to that 
symbol. The length attribute of a symbol may not be changed. 
The attributes of an instruction may not be changed. 


QUALTFY ABC@T=X 


The type attribute of ABC is changed to X (hexadecimal). 
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Prototype: 


‘Action: 


RESET 


DEBUG COMMAND DESCRIPTION 


RESET 


All SDS operational parameters are 


values. 


reset to their 
A list of these defaults, and the corresponding 
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default 


commands to change their values, is presented below. 


Parareter 


SDS command source 

SDS output sink 

Attention interrupt switch 
Program interrupt switch 
SDS prefix character 
Default type 

Default length 

Default scale factor 
Default relocation factor 
Terse mode switch 

At-msode prefix character 
Indirection character 
Modifier character 
Open=-map character 
Blank-named common. sysbol 
LINK/LOAD/XCTL switch 
Errore-dump facility 


tInitially, the command source and output 


respectively. 
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Default 


*MSOURCE*? 


*MSINK*! 
ON 

ON 

+ 

X (hex) 


sink are 


Command 


SET 
SET 
SET 
SET 
SET 
SET 
SET 
SET 
SET 
SET 
SET 
SET 
SET 
SET 
SET 
SET 
SET 


*SOURCE* 


INPUT 
OUTPUT 
ATINTRP 
PGNTTRP 
PREFIX 


and *SINK*, 
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Action: 
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RESTORE 
DEBUG COMMAND DESCRIPTION 


RESTORE [simple-parameter ...] 


If no parameter is specified, the most recently entered 
global breakpoint or at-point set by the BREAK or AT command 
is removed from the user's program and the original instruc- 
tion is restored. If one or more simple parameters are 
specified, the breakpoint or at-point at each location is 
removed and the original instruction is restored. 


RESTORE LOC2 


The breakpoint or at-point at location LOC2 is removed from 
the progran. 
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ROY 
DEBUG COMMAND DESCRIPTION 


RUN (simple-parameter ...] 

Control is.transferred to the entry point of the program and 
execution is started. General registers 1, 13, 14, and 15 
are set to the following values: 


GR1 points to the system parameter list. 
GR13 points to a system save area. 

GR14 contains the return address. 

GR15 contains the entry point address. 


The other registers and the floating-point registers are set 
to zero. The entry point and the system parameter list may 
be changed by the ENTRY and PAR options of the SET command. 


If a simple-parapeter is specified, a local breakpoint is set 
at the location specified. This breakpoint code is an 
X*0004* which replaces the instruction. When the program 
encounters a lccal breakpoint, control returns to debug 
command mode. Local breakpoints are in effect only for the 
duration of the command, and are automatically erased before 
the user enters his next command. 


For programs that are serially-reusable, that is, they are 
capable of being rerun several times without being reloaded, 
the RUN command may be used to restart the program at its 
entry point. Programs that are serially-reusable are either 
re-entrant or they do not modify their constant areas. 


RUN LOC2 


A local breakpoint is set at location LOC2 and execution of 
the user's progras is initiated. 
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Prototype: 


Action: 


Examples: 
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SCAN 


DEBUG COMMAND DESCRIPTION 


SCAN [ {section|address1...address2|*} "value ] 


If section is specified, SDS. searches through the naned 
section in an attempt to find the value specified. The type 
and length attributes (and/or modifiers) of the section 
parameter determine how the value is converted for the 


search, The value given must be enclosed in primes. 


If addressi...address2 is specified, then address1 and 


address2 are the lower and upper bounds of the area to be 
searched, Value is converted according to the type and 


If * is specified, SDS searches through all loaded sections 
and defined dsects. value is converted according to the type 
and length attributes of *. 


If the type specified is hexadecimal, character, or packed or 
zoned decimal, the length of the constant specified is taken 
as the length of the value to scan for; otherwise, the 
default type and length attributes are used for the scan if 
no TYPE and LENGTH modifiers are specified on the first 
parameter. 


If no parameter is specified, the search resumes starting at 
the first location beyond the previous match from the 
previous SCAN command. 


The search for the specified value is performed with respect 
to the appropriate boundary alignment of the value specified, 
that is, instructions are scanned for on halfword boundaries, 
character constants on byte boundaries, and so on. 


SCAN MAIN@T=E@L=8 '3.33762! 


The section MAIN is scanned for the double~precision 
floating-point constant 3.33762. 


SCAN 5176100...5162DBaT=C ‘OUTPUT! 
SCAN 


The region 516100...5162DB is scanned for the character 


constant OUTPUT. The remainder of the same region is scanned 
for a second occurrence of OUTPUT. 
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SDS 
DEBUG. COMMAND DESCRIPTION 
Prototype: sps 
Action: If an at=point command list is being processed, the command 


list processing is terminated and control is returned to 
debug command mode. The SDS command should be given as the 
command preceding the END command in the at-point command 
list. 


If the user is in debug command mode, no action is taken. 


This command is not the same as the MTS SSDS command which is 
used to enter debug command node from MTS command mode. 


Examples AT Locs 
DISPLAY A (1). (9) 
DISPLAY FRS 
SDS 
END 


After the command list for the at-point at location Loc5 is 
processed, control is returned to debug command mode. 
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Actions: 
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SET 


DEBUG COMMAND DESCRIPTION 


The SET command 


SET keyword-parameter ... 


is used to alter the status of a number of 


SDS options, default attributes, or default characters. The 
valid keyword parameters are as follows: 


ATPREFIX=char 


ATTN= {ON | OFF} 


BLANK=chars 


ENTRY=loc 


ERRORDUMP={ON | OF F} 


INDC H=char 


INPUT=FDnane 


The ateinsertion mode prefix character 
becomes the character specified by char. 
The default is the "%" character. 


If the option is OFF, user attention 
interrupt exit routines set up by calls 
to the subroutine ATTNTRP are disabled. 
Consequently, SDS processes all attention 
interrupts. The option may be set to OFF 
before or after the user's program has 
called the subroutine ATTINTRP. The 
option may be set to ON to restore normal 
interrupt processing. The default is ON. 


The blank-named common symbol used to 
refer to blank=-named common sections 
becomes the character string specified by 
chars. The symbol may not begin with the 
indirection character ($), and may not 
contain any of the following characters: 
Qit",.=' or the modifier character (0). 
The default value is BLANK. 


The entry point to the user's program is 
set to the location specified by loc. 
loc may be a symbolic, relative, or 
virtual address. 


If the option is ON and the user is 
running in batch mode, a symbolic dump is 
automatically given for abnormal program 
termination. The default is OFF. 


The indirection character becomes’ the 
character specified by char. The default 
is "$*, 


SDS reads subsequent commands from the 


file or dewice specified by FDname. If 
an endeof-file is detected from the new 
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LEN=i 


Logical I/O Units 


MODCH=char 


OMA PCH=char 


OUTPUT=FDnarge 


PAR=text 


PGNT= {ON (OFF} 
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command stream, or if an attention inter- 
rupt, a program interrupt, or a break=- 
point (pot an at-point) is encountered, 
SDS returns to *MSOURCE* for its con- 
Bands. The default is *SOURCE*. 


The default length attribute is set to i, 
where i is an unsigned decimal integer : 
between 1 and 256. Initially, the 
default length attribute is 4. 


Logical I/70 unit assignments for the 
user's program may be given for both 
input and output units. This may be used 
to reposition files but does not affect 
the status of other types of pseudo- 
devices (such as *SOURCE* and the posi~ 
tion of tapes). 


The modifier character becomes the 
character specified by char. The default 
is the "@" character. 


The “open-map" character becomes the 
character specified by char. The default 
is the "*" character. 


SDS writes subsequent output lines to the 
file or device specified by FDname. If 
an attention interrupt, a program inter- 
rupt, or a breakpoint (not an at-point) 
is encountered, SDS switches its output 
to *MSINK*. The default is *SINK*. 


The system parameter list becomes the 
character string specified by text. 
Since text includes the remainder of the 
input line, the PAR option must be the 
last option specified on the SET command. 
A 6 blank character is always added at the 


end of text. 


If the option is OFF, user program inter= 
rupt exit routines set up by calls to the 
subroutine PGNTTRP are disabled, SDS pro=- 
cesses all progran interrupts. | The 
option may be set to OFF before or after 
the user's program has called the subrou+ 
tine PGNTTRP. The option may be set to 
ON to restore normal interrupt proces- 
Sing. The default for this option is ON, 
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PREF IX=char The SDS prefix character becomes the 
character specified by char. The default 
is the "+" character. 


RF=constant The unsigned hexadecimal constant defines 
the default relocation factor. This con- 
stant is added to every relative address 
which is not qualified by the a@c= aodifi- 
er. The default value for the relocation 
factor is 0. 


SCALE=i The default binary scale factor is set to 
i, where iis a signed or an unsigned 
decimal integer. Initially, the default 
scale factor is 0. 


TERSE={ON| OFF} If the option is ON, SDS enters terse 
mode and eliminates many confiraation and 
diagnostic messages. If the option is 
OFF, normal message processing occurs. 
The default is OFF. 


TYPE=code The default type attribute is set to 
code, where code is any of the single 
character SDS type codes described with 
the description of the TYPE keyword modi-= 
fier. Initially, the default type attri- 
bute is X (hexadecimal). 


XFR= {ON| OFF} If the option is ON, SDS intercepts all 
calls to the subroutines LINK, LOAD, and 
XCTL and returns to debug command mode. 
The modules specified in the subroutine 
call are loaded and the registers are set 
up for the execution of the loaded 
modules (in the case of LINK and XCTL). 
For XCTL, the calling program is unloaded 
and its symbols are purged from the SDS 
map. If the option is OFF, SDS does not 
intercept the subroutine calls. The 
default is OFF. 


SET LEN=8 TYPE=C TERS E=ON 
This command sets the default length attribute to 8 bytes, 
the default type attribute to C (character), and sets terse 
mode ON. 

SET SCARDS=INPUT SPRINT=OUTPUT PAR=EXEC 
This command sets SCARDS and SPRINT to the files INPUT and 


OUTPUT, respectively, and sets the system parameter list to 
the character string EXEC. 
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STEP 
DEBUG COMMAND DESCRIPTION 


STEP [i] 


The next j gpachine language instructions in the user's 
program are simulated before control returns to SDS. If i is 
not specified, only the next instruction is simulated. 


If the user attempts to STEP past a branch instruction, the 
branch is taken as usual unless the prograsa is transferring 
to a legal low-core syambol such as SCARDS or SPRINT. In this 
case, the routine is executed, not simulated, and stepping 
resumes at the return address. The instructions executed in 
the routine are not counted in the stepping count. 


If the branch address is less than 300000, and does not 
correspond to the entry point of a legal low-core syabol, 
simulation is terminated and a warning message is printed. 


The user eust restart his program with either a CONTINUE or 


GOTO command. 


If STEP is used instead of RUN to initiate program execution, 
registers 1, 13, 14 and 15 are loaded with the appropriate 
values. (See the RUN command description.) 


FORTRAN users should note that the STEP command specifies 
Bacbine langyage instructions in the count. To step a 
specified nusber of FORTRAN instructions, the CONTINUE com- 
mand should be used specifying temporary breakpoints. 


STEP 10 


The next 10 machine instructions in the program are 
sisulated. 
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STOP 
DEBUG COMMAND DESCRIPTION 
Prototype: STOP 
Action: SDS processing is terminated and control is returned to MTS 


command mode, 


All loaded sections are unloaded; all loaded program syabol 
table information and the basic SDS work storage is released. 
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SIEBOL 
DEBUG COMMAND DESCRIPTION 


SYMBOL simple-parameter ... 


The location specified by each siaple parameter is printed in 
symbolic format. If no symbol table is present, the relative 
address and section name are printed. If this cannot he 
done, the corresponding virtual address is printed. 


SYMBOL ALPHA ALPHA+4 $GR14 516020 


This example displays the above locations in the following 
form: 


ALPHA = ALPHA IN SECTION PROG 
ALPHA+4 = VSYS IN SECTION PROG 
$GR14 = LINK(8)4#2 IN SECTION MAIN2 
516020 = BETA IN SECTION SUBR 
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Action: 


Examples: 
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USING 


DEBUG COMMAND DESCRIPTION 


USING dsect=-name. address 


The dsect named by dsect-name may be assigned an address in 
two ways: 


(1) address is a simple parameter which is used as a 
static base address for the dsect. 
(2) address is a general register, the contents of which 
are used as a dynamic base address for the dsect 
(that is, the base address varies with the contents 
of the register). 
A dsect may be redefined by subsequent USING commands. 


If the dsect name occurs in more than one assembly, the ac 
modifier may be used to specify the desired dsect. 


The DROP command may be used to undefine a dsect. 
USING DSECT1 GR1 


The dsect DSECT1 becomes dynamically addressable by the 
contents of general register 1. 


USING DSECT2 516200 


The dsect DSECT2 becomes statically addressable by the base 
address 516200. 


USING WORKAREA@C=SUBA SWADDR 
The dsect WORKAREA from the assembly which contains the 


section SUBA becomes statically addressable by the current 
contents of the location WADDR. 
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ABNORMAL CONDITIONS 


The following paragraphs describe various abnormal conditions that aay 
occur during the execution of a program, how the resulting interrupts are 
usually handled, and how the user may prepare to intercept them if they 
should occur. 


There are several categories of interrupts, depending on what the progran 
is doing. In this section, four categories are discussed, 


Fifteen different conditions cause a program interrupt (exception). 
These are the following: 


Program Interrupt Cause Interruption Code_ (hex) 


Operation 

Privileged operation 
Execute 

Protection 
Addressing 
Specification 

Data — 

Fixed-point overflow 
Fixed-point divide 
Decinal overflow 
Decimal divide 
Exponent overflow 
Exponent underflow 
Significance 
Floating-point divide 


yO ONOrF ODWANN FWD a 


For a complete description of the meaning of these program interrupt 


conditions, see the IBM System/360 Principles o£ Operation, IBM form 
A22-6821. Normally, when one of these conditions occurs, the message 


USER PROGRAM INTERRUPT. PSW=xxxxyyyy cxzzzzzz 


is printed. The digits "yyyy" give the interruption code, and the digits 
"ZZzZzzZz" give the location causing the interrupt. The first two bits of "c* 
give the instruction length code and the last two bits give the condition 
code. Program interrupt conditions 4 and 5 (protection and addressing 
exceptions) are caused by the user's program specifying an invalid address. 
An addressing exception is caused by an address specified outside the range 
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of virtual memory. A protection exception is caused by specifying an 
address in virtual memory which is not legal for the user's program to 
specify (usually an address reserved for the system supervisor). A 
protection exception may be an “imprecise" interrupt. (This occurs because 
the interrupt condition is discovered and flagged by the storage unit, not 
by the CPU, and hence the position of the CPU's location counter is 
iuprecise.) An “imprecise" protection exception is indicated by the 
instruction length code (ILC) in the PSW being set to zero. After a program 
interrupt has occurred, the following happens: . 


(1) The general and floating-point registers are saved. 
(2) A storage dump is given only in batch sode, if previously requested 
by one of the following MTS commands: 


SERRORD UMP 
S$SET ERRORDUMP=ON 
SSET ERRORDUMP=FULL 


(3) Control is returned to MTS command mode. 


When a return is made to MTS command mode, the user can give any 
legitimate MTS command, including SRESTART, which causes the program to 
continue execution at the instruction following the one causing the progran 
interrupt (assuming that the interrupt was not "imprecise"). 


A programmer can alter the normal processing of a program interrupt in 
several ways. 


The BPI (branch on program jnterrupt) macro may ke used in 360-assembler 
programs to specify a branch address to be taken when a specified type or 
class of interrupt type occurs. See the BPI macro description in Volume 3 
for the complete description, calling sequences, and examples of usage. 


The subroutine PGNTTEP (program ipterrupt trap) allows the user to 
specify his own exit routine which is transferred to upon the occurrence of 
a program interrupt. When the interrupt occurs and the exit is taken, the 
intercept is cleared so that another call to PGNTTRP is necessary to 
intercept the next program interrupt. PGNTTRP can be called directly from a 
360-asseabler program and indirectly through the subroutine RCALL in 
FORTRAN. See the PGNTTRP subroutine description in Volume 3 for the 
complete description, calling sequences, and examples of usage. 


The subroutine SPIE (specify program interrupt exit), which is callable 
from a 360-assembler program, not only allows the user to specify an exit 
routine to be taken, but also provides the facility to specify the class of 
program interrupts for which this exit should be used. For any of the 
fifteen program interrupts not specified, the normal program interrupt 
procedure is followed, The specifications set up by a call to SPIE remain 
in effect until a subsequent call overrides then. This subroutine is 
normally called by using the SPIE macro. See the SPIE subroutine and macro 
descriptions in Volume 3 for the conplete descriptions, calling sequences, 
and ¢xaaples of usage. ! 
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When a program interrupt occurs, a check is first made to determine if 
any of the immediately following instructions are BPI macro instructions. 
If there is one, the type of program interrupt that occurred is compared 
with the type specified by the BPI macro. If there is a match, the 
condition code is set to reflect the interrupt that occurred and the branch 
is taken. If there is no BPI transfer made (either because there was no BPI 
instruction or because the program interrupt type did not match the BPI 
type), then a check is made to determine if a PGNTTRP (or SPIE) exit is 
active. If there is one, the exit is taken; otherwise, the program 
interrupt message is printed and a return is made to MTS command mode. 


In PL/I, many asynchronous conditions are predefined as ON-conditions. 
Therefore, the user can determine by means of the ON statement what 
processing should occur upon the occurrence of one of these conditions. The 
following program interrupts are among these predefined conditions: 


Program Interrupt ON=condition Code 
Fixed-point overflow FIXEDOVERF LOW 
Fixed=-point divide ZERODIVIDE 
Exponent overflow OVERFLOW 

Exponent underflow UNDERFLOW 
Floating-point divide ZERODIVIDE 


Those asynchronous conditions that are not predefined cannot be intercepted. 
Those that cannot be intercepted and those that the user chooses not to 
intercept are handled by the PL/I library. See the IBM System/369 PL/I 
Reference Manual, IBM form C28-8201, 


Attention interrupts usually occur when a user is executing froma 
terminal and presses the ATTN or BREAK key. The system responds with 


ATTN! 
or, if a program was in executicn 
ATTENTION INTERROPT AT xxxxxxxx 


where "xxxxxxxx" is the hexadecimal address of the point of interruption. 
The system returns to MTS command mode. Once in command mode, the user may 
give any legal MTS command. In particular, if the interrupt occurred during 
execution of a program, the program can be restarted from the location at 
which it was interrupted by issuing a $RESTART command. 


The subroutine ATINTREP (attention interrupt trap) allows the user to 
specify his own exit routine which is transferred to upon the occurrence of 
an attention interrupt. When the interrupt occurs and the exit is taken, 
the intercept is cleared so that another call to ATINTRP is necessary to 
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intercept the next attention interrupt. ATINTRP can be called directly from 
a 360-assembler program and indirectly through the subroutine RCALL in 
FORTRAN. See the ATTNTRP subroutine description in Volume 3 for the 
complete description, calling sequences, and examples of usage. 


TIBER_ INTERRUPTS 


Three different types of timer interrupts may occur while a program is 
executing. They are: 


(1) Global time limit exceeded, which can happen only in batch mode, and 
is determined by the TINE parameter in the $SSIGNON command. 

(2) Local time limit exceeded, which can happen either in batch or 
conversational mode, and is determined by the TIME parameter in the 
SDEBUG, SLOAD, S$RESTART, S$RUN, and SSTART commands. 

(3) Program specified timer interrupts, which are established by calls 
on certain systen subroutines. 


The first two types result in the system message 
***GLOBAL TIME LIMIT EXCEEDED AT XXXxXxXXxXxX 
or 
*e*X7LOCAL TIME LIMIT EXCEEDED AT xxxxxxxx 


where “xxxxxxxx" is the hexadecimal address of the point of interruption. 
These conditions cause a dump in batch mode if the EFRORDUMF option is 
specified. Neither of these interrupts can be intercepted by a program, but 
it is possible to determine the times at which they occur (via the GUINFO 
subroutine) and set up a program specified timer interrupt to occur before 
the global or local limit occurs. Thus, a program can arrange to print more 
useful diagnostic information in cases of infinite loops, and so on. 


Program specified timer interrupts are set up by calls to the subroutines 
TIMNTRP, SETIME, GETIME, RSTIME, TWAIT, and TICALL which are described in 
Volume 3. These subroutines provide for the enabling and disabling of timer 
interrupts, and the specification of time intervals in several forms, 
including real time or task time, relative or absolute time, and in units of 
microseconds, timer units, or character string time of day. 


INPUT AND OUTPUT ERRORS 


The input and output of data by programs is handled by I/O subroutines 
called from the program. The I/O subroutines always provide a return code, 
the exact meaning depending on the file or dewice used in the operation. A 
description of the return codes that may occur with a particular file or 
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device is given in the appendix "I/O Routines! Return Codes" in the section 
"Piles and Devices" in this volume. 


In general, a return code of zero means successful completion of the 
input or output operation, and a return code of 4 means end-of-file-or- 
device for an input operation. Return codes greater than 4 normally signify 
an error condition and are not passed back to the caller, but instead cause 
an error comment to be printed and control to be returned to MTS command 
mode. The error comment usually describes the error condition and its 
location. When a return is made to command mode, any legal MTS command may 
be given. 


There are two ways to suppress this error handling procedure and to asake 
the calling program regain control. The subroutines SETIOERR and SIOERR 
allow the user to specify the location of a user supplied subroutine to be 
called upon the occurrence of an I/O error. Thus, when an T/O error occurs, 
the user supplied subroutine is called. This subroutine performs its tasks 
and returns to the I/O routine. The I/O routine then returns to the 
original calling program as if no error had occurred, except that the error 
code indicates which type of error happened. The error exit set up by 
SETIOERR or SIOERR remains in effect until overridden by a new call or until 
the program terminates normally. SETIOERR is for 360°-assembler language 
users and SIOERR is for FORTRAN users. See the SETIOERR and SIOERR 
subroutine descriptions in Volume 3 for the complete description, calling 
sequences, and examples of usage. 


The second way to suppress the error comment and return the error code to 
the calling routine is through the I/0 modifier ERRRTN. If this modifier is 
specified in an I/O subroutine call and no SETIOERR-SIOERR interception has 
been established, then when an error occurs, the return code is passed back 
to the calling routine and no error comment is printed. 


PL/I has predefined many of the I/0 errors as ONeconditions. Thus, 
processing of these interrupts can be determined by ON statements. 
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When running a program in batch mode, a hexadecimal dump and a load map 
may be useful tools in debugging a program. If the program ends abnormally 
and a dump has not been requested, only the program status word (PSW) and 
the general and floating-point registers may be obtained. This may not be 
enough information to find out where and why the program produced the error. 


The user may use the MTS $ERRORDUMP command to obtain the contents of his 
virtual memory, as well as other information, if the program is terminated 
abnormally. If the program terminates normally, no dump is generated. 
Before running the program, the MTS command SERRORDUMP or the command SSET 
ERRORDUMP=ON should be given. The MAP parameter to the S$RUN command may be 
given to obtain a load map. The map is produced regardless of how the 
program is terminated. 


In the example described below, the assembly language subroutine in the 
file TEST contains an intentional error for illustrative purposes. This 
subroutine is assembled into the file QUAD. The program in the file 
TESTCALL is a simple calling program to test the subroutine. This progran 
is assembled into the file QUADCALL. The commands to assemble and run_ the 
sample program described below are: 


SRUN *ASMG SCARDS=TESTCALL SPUNCH=QUADCALL 0=*SYSMAC 
SRUN *ASMG SCARDS=TEST SPUNCH=QUAD O=*SYSMAC 
SERRORDUMP 

SRUN QUADCALL4QUAD MAP 


The map is printed immediately after the program has been loaded, and 
before execution of the program begins (see below). All the numbers in the 
map are hexadecinal. The “ENTRY=xxxxxx" is the address of the first 
instruction to be executed. "SIZE=xxxxxx" is the sum of the lengths of all 
the loaded control sections. The NAME is the name of the external symbol; 
its VALUE is the actual address assigned to the external symbol. If the 
value is six dashes, the external symbol is undefined. "T" gives a type 
indication for the symbol. This column may contain "*" for system syabols, 
*c" for program common sections, "D" for symbols defined with a DEF control 
record, "P" for pseudo register storage, or blank, for all others. Every 
symbol which is the name of a control section also has a relocation factor 
printed in its entry. This is the number which nust be added to the given 
address in the assembly listing to get the virtual memory address. 


The first line of the dump contains the date and time of the dump 
initiation. The second line is the program status word . (PSW). This 
contains information about the program; a full description. may be found in 
the section titled "Status Switching" in IBM Systerm/360 Principles of 
Qperation. A summary is given in the IBM System/360 Reference Data card 
(usually referred to as "the green card"). Only those parts of the PSW most 
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cosaonly used for debugging are explained here. The last three bytes (last 
six hexadecinal digits) are the address in virtual memory of the instruction 
following the one being executed at the time of termination. In the case of 
a program interrupt, the second and third bytes (last four hexadecinal 
digits of the first word) contain the interruption code. (It is sufficient 
to look only at the third byte.) The interruption code explains the reason 
why the program interrupt occurred. It may be that an instruction 
referenced an address that is outside the user's virtual memory space 
(interrupt code 5) or that an illegal operation code was encountered 
{interrupt code 1). The interrupt codes are summarized in the section 
"Abnormal Conditions" in this volume, and the causes of various types of 
interrupts are listed in the section titled "Interruptions" in IBN Systea/ 
360 Principles of Operation. Another iten which is occasionally useful is 
the condition code. This is set by comparisons and a number of other 
instructions. It occupies bits 2 and 3 of the fourth byte! of the PSW (last 
two bits of the first hexadeciaal digit in the second word). Its values are 
0, 1, 2, and 3 and these correspond to values of 8, 4, 2, and 1 respectively 
in the mask of the branch-on-condition instruction. 


Program Status Word 


ew 
I re | {| Interruption Code { 
terre ele rete leer riellveneereneerere nner memes cenatann sais winamp ll 


0 78 +1112 15 16 31 


] { cc |} { Instruction Address 


32 33 34 35 36 39 40 en) 


See the Principles of Operation for the complete 
description of the Program Status Word. 


Following the PSW is a one line heading and two lines displaying the 
contents of the general registers. The first line shows general registers 0 
to 7, and the second line shows general registers 8 to 15. Information 
which may be verified from the contents of the general registers includes 
the correct value of the base register, the last location from which a 
subroutine call was made (usually in general register 14), the location of 
the current save area (general register 13), the return code from the last 
called subroutine (usually in general register 15), and the values of 
computations involving general registers. 


After the general registers, the four floating-point registers (0, 2, i, 
and 6) are displayed. These say be used to check on values produced using 
the floating-point instructions. 


‘Bytes of the PSW are numbered 0+7, and bits within a byte are numbered 0-7 
(from the left). 
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Loc 


0.00000 


000014 
000018 
00001C 
000020 


000032 
000034 
000038 
00003Cc 
000040 
000044 
000048 
00004C 
000050 
000054 
000058 
00005c 


0000A8 
0000aAC 
0000B0 


Loc 


000000 


000014 
000018 
00001Cc 
OO0001E 
000022 
000026 
00002A 
00002c 
000030 


O0004A 
Q0004E 
000050 
000052 
000056 
000058 
00005Cc 
000060 
000062 


0000Cc4 
0000c8 


000110 
000114 


April 1974 


OBJECT CODE 


5890 COA8 
5810 COAC 
58F0 COBO 
OSEF 


0000 

00000048 
0000004C 
00000050 
00000054 
00000058 
41200000 
41500000 
c1c00000 


FFFFFFFF 
00000034 
00000000 


OBJECT CODE 


9826 
7800 
3c00 
7820 
7020 
7020 
3B02 
4740 
7000 


1000 
3000 


c110 
2000 
4000 


co78 
cocy 


7820 
3A22 
3340 
7B&O 
3D42 
7040 
7B00 
3D02 
7000 


2000 


3000 


9000 
3000 


5000 


41400000 
00000000 


Figure 1: 


ADDR1 ADDR2 


000A8 
OO0aAC 
000B0 


ADDR1 ADDR2 


00000 
00000 


00110 
00000 
00000 


00078 
000c4 


00000 


00000 


00000 
00000 


00000 


LINE # 


1.000 
2.000 
3.000 
4.000 
5.000 
6.000 
7.000 
8.000 


9.000 
10.000 
11.000 
12.000 
13.000 
14.000 
15.000 
16.000 
17.000 
18.000 
19.000 
20.000 


LINE # 


1.000 
2.000 
3.000 
4.000 
5.000 
6.000 
7.000 
8.000 
9.000 
10.000 
11.000 
12.000 
13.000 
14.000 
15.000 
16.000 
17.000 
18.000 
19.000 
20.000 
21.000 
22.000 
23.000 
24.000 
25.000 
26.000 
27.000 
28.000 


SOURCE 


PARLIST 


SOURCE 


QUAD 


Qt 


Q2 


Q3 


Q4 


Q5 


COMPLEX 


DISCR 
SAVE 


Sample Asseabler Prograa 


x 


MTS Volume 1: 


STATEMENT 


PRINT 
START 
ENTER 12,SA=SAVE 

L 9,=Ft-1t 

L 1,=A (PARLIST) 
L 15,=¥ (QUAD) 
14,15 

EXIT 0 


NOGEN 


pc A(A) 

pc A(B) 

pc A(c) 

pe A(ANS1) 
pc A (ANS2) 
pc E'2.0¢ 
DC E'5.0¢ 
pe E'-12.0' 


ps E 
DS E 
ps 18F 
END 
=Pt- ft 
=A (PARLIST) 
=V¥ (QUAD) 
STATEMENT 


PRINT WOGEN 
START 

ENTER 12,SA=SAVE 
La 2,6,0(1) 
LE 0,0(,3) 
MER 0,0 

LE 2,=E8°48 

NE 2,0(,2) 


ME —-.2,0(, 4) 
SER 0,2 
BM COMPLEX 
STE 0,DISCR 
CALL SQRT,DISCR 
LE 2,0(,2) 
AER 2,2 
LCER 4,0 
SE 4,0(,3) 
DER. 4,2 
STE 4,0(,9) 
SE 0,0(,3) 
DER 0,2 
STE 0,0(,5) 
EXIT 0 
SERCOK 
EXIT 4 
DS g 
DS 18, 
END 
=E'Gt 
=V (SERCOM) 


MTS == The 


ADDRESSES OF ARGUMENTS 
B 
B*B 


4a 
4eAec 


SQRT(B*#2-4*A4C) IN FRO 
a 


ACA 
~SQRT (B#*2-4*A*C) 

~B-SQRT (B¥*#2-4 #4 #C) 
(-B-SQRT (B¥#2-4*A*#C) ) / (2*A) 
SECOND ROOT 

-B+SQRT (B**#2-5% A¥C) 
(~B+SQRT (Bt*2~4*A*C) ) 7 (2*A) 
FIRST ROOT 


‘ *#* EQUATION HAS COMPLEX ROOTS* 
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ENTRY = 5001D8 sxzz = o001cC 


GARE VALUE T RF WARE VALOR f &F WARE VALOR T AF 
SERCOR 221a3c * LCSYBBOL 222810 * *  $RPL> 275900 * 
sqer 270218 * 5001D8 $001De8 Qua~AD $00290 500290 


<SY¥MTAB> 501000 #501000 


ae ee cee wee cee ee wee cee wee cee cee cen bos cee eee cee cee oe 


DATE 01-26-73 TIME 18:26.35 
pss = 07150006 905002sC 


GEMBRAL REGISTERS 0...15 


P7208D61 =£05002D0 «= 00500220 = 90500228 §=—6.00500228 §=69050022c §=—: 000500230 §=— 00000000 
00000000 0s PrFFFFFF 600000000 «00000000 §«00500290 §=—00500358 =6—60S002DA «=: 00000000 


PLOATING POINT REGISTERS 
#1300000 00000000 81860000 00000000 C1HO0000 00000000 00000000 00000000 


STORAGE INDEX: 0000 
a, 


La 

500000 00000000 00000000 61618181 89878181 81818761 1810181 81818781 01918167 *........ AMARAAAADAAAAABAAAAKAAAA® 
500100 000100 80500000 00241688 005001D8 81818182 00000000 00500238 00211658 00500108 #.8.......8.QMAAR ec. 0 cba cee e 8.08 
500120 000120 00000000 00560100 00000000. G6000000 00000000 90000000 o0c0G000 90000000 *.....8. * 
500180 060180 00000000 00000000 00000000 00000000 00000000 81818161 1c818181 81918181 *.......cscccccsccescABAA AMAABAAS 


CSBCT: ADDR: 50071D8 RELOC: 5001D& LENGTH: 000086 STORAGE INDEX: 0080 
ua aa 
$001Cc0 90RBCBOOC 18CPA1PO Bocce ee OF 


500180 000008 cOScSOFO p00SSODO PoOs1sDF S890COAS SBIOCOAC SBOPOCOBO OSEPSEDO DOONSEEC 9.960. .6.0... cee Loree Des enee ne Qe® 
$00200 000028 poOcoarr pCOcIBFF O7FR0000 90500220 00500228 005002268 0050022c 00500230 nel ees 2d 
500220 000088 81200000 &1500000 c1c00000 40000000 00000000 O0006SEF 0050010c 00500358 


ran 2rd od 
500280 000068 805001FA 00500290 00000000 0050020C ‘90000000 00000000 00000000 09000000 + $...6.. seen en eet 
500260 000088 d0000000 0000000 a0000000 rFrrrrrr 00000000 00000000 O0S00TDA BOHONOND OL... reer reccceccceen nee hid * 
$00260 00008 «FFFFPFFF 0050020C 00500290 B2c1E2E5 Won be nob e e SASYF 
Csect: Qvap ADDR: 500290 RELOC: 500290 LENGTH: 000116 STORAGE INDEX: 0060 

ba a, 

500260 SORCDOOC T8SCPHIFO COceSOPO »p00850D0 
500280 000010 700818DP 98261000 78003000 3€007820 C1107C2O «=—20007C20 «480003802 s7R0COTA *0...9 
5002c0 000030 7O00C0Ce 87FOCO3C 00278RTS HS 1OC0Ns 00500358 Sérpoco3s OSEP7620 20003822 *...D. 
$00280 000050 33807880 30003082 76809000 78003000 3D027000 S00058D0 pooKSsac DOOCS2RPF *. # ...... 
500300 600070 DOOCIBPF 07780700 SsFoctia 4&510CO0aR 0050034B 9050031C O0000000 DOTPROSC Foc cece ee ONs cece Boe ebaenccens BF 
500320 000090 SC5C8OCS DAaROCTE3 COD6EDSSG C8C12B200 C3D6DAD7 DICSH7HO DIDGDERI E2000SRF Fes EQUATION HAS COMPLEX ROOTS...* 
500380 000080 Sspop00s 98EcD00C S2FFD00C 41780008 OTPRCIB2 82790000 CBC1B3R0 00500238  9....0.0.K e000... ASees DAT .6..* 
$00360 Cc0OpO §«=6— 8ODARIH2 =FFSOOZDA 00279818 oCsoO”EgS 40800280 00500220 00000000 $8000000 © uTs.¢&.. Peet Peer eee ee iad 
$00380 CooOPO §«oc0e00e0 De0067DD 00000000 00000000 00000000 00000000 «1000001 00000000 *.... Pere rree eerie rere reer eras 
500380 000110 41800000 0022183C * o 


CSECT: <SYATAB> ADDR: 501000 RMBEOC: 501000 LESGTE: 002000 STORAGE ImDBX: 0000 
La ma ‘ 
301000 06002000 81616181 90501550. 20211482 00001000 00000000 00500470 202415aB 
$01020 000020  50210RF8 00800000 00500160 00000000 00220968 00211BA0 005001D8 002185¢C 
$01680 000060 00219956 C62139Se 40600007 81818181 81818167 00501000 81816181 80002R38 
$01060 000060 00000000 00000000 ocsotone s0c01g14 GOSOteSS 00000003 00501820 00501918 
501060 000080 00501000 00501000 00000000 00003000 800015SA 602118DR 00003384 
501080 000020 00002000 00803D3C + 00803CD8 00800000 00000000 00803c99 00801860 
$010C0 0000CO 00802000 00800000 cd21Cctéc 00218958 00213958 00501808 00501238 00002888 
50100 OG0eRO 00501308 0050123c a0SOTOFe 00501238 00008015 OOSOtIFC 005011B8 00501320 
$01100 000100 60603030 00002000 00001000 90000000 00501888 000001D0 00500%D8 60500290 
501120 000120 00501888 00501238 G0S01318 00000010 06000001 00000020 00003000 90001836 
$0110 000180 00000000 Go2orSBB 0O211BAG 816178181 81818781 08000038 00275128 005018N8 *......5..06. 
501160 000160. G0SOTHnA OCO20FSER 81818181 87618181 81818181 S18IBTST OODCDCOO BOCOTEPA *.6.0..5. AAARAAAABAAARAAR. 
$01160 000180 00000001 00001970 00000000 00501538 Ce0008OR 00207296 OO20F7SER 00211820 eee Cee Cetra iret Pern 
So%tad CodtAd §«©0dd00080 oo21BSCC 00500299 00000000 00000198 818018181 81816181 00502806 soos BAAAAAAA.S.. 
$011¢0 O001CO 80503006 90500290 o0S001De 00000000 QO21FT1B 0022186C 0020F296 CO20RSEE 2 Teen hee 20.08, 
501180 000180 00220964 00000000 063903000 00270789 00503B6P 00000200 00002aDe 80060007 
$01200 000200 67000000 00000007 00000600 co000000 00000000 o0000Icc O0000TTS o00d0118 
501220 000226 0600000 0000197c ceGc0086 00000080 @1818181 00001858 00010000 00160087 
-§01280 GO028O 6161DESS CICSSORO 8O80DEEH CcIcesasO 86800008 090000000 90000900 00000000 
501260 000260 90900000 00000007 90050000 00000000 00000000 00000000 00000000 00090006 
501260 000260 0000000 ce0s0000 aocggooe § oCco0N00 G0000800 00000000 o0000000 000000 
501280 000240 cooees0o coooODee COOddCED 90000000 00006060 00000000 o0000000 00020000 
$012c0 O9e2c0 «= 69000009 60000000 . 06009000 B2neDsE3 40806080 00276218 00000000 o0008s00 
501280 000280 60000000 00000000 00000000 005003486 COSOtarh 900000TC 00501000 Prororsro 


2 008.2 -6.066..% 
Sone B.Q.8 


501300 000300 PIFOPOFO OF818181 SODICOR3 80808080  —80R0KORO 804080KD 80808000 80808080 *1000.8ak LOT 

501320 000320 PIFS7AFS F2SBF1F9 SO80KOKD SORCKOC1  EZDACTSO F7FZD1E4 D3P9NC80 AOFIPE7A #19:52.19 ASKG 723019 18:4 
501340 000380 P2PSUBP3 F9AOSOF1 SOCECSC2 SOFTP300  8O8080ND POFOPIP? 81816181 81816181 25.39 1 FEB 73 OOTIAMAAAARA® 
501600 000000 81610101 81818181 40R080ND 40808DRD 80408080 KORDKOSO 80808080 40408080 *ARBABAAA ‘ 
501080 000880 B06080RD SO50RCRO 8O80ETSD S0NDRORO 80808080 40808080 ACRZEgDN B3CICI6R * <staTap>e 


501860 000860 00501000 00501000 Gedoatos 00000000 80000060 00000000 DICINZBE DACZDEDT %.8...6.. ce reeceececsees eLCSYMBOL* 
501480 000880 «600222810 «coceecCO aocOSsse00 600800000 00600000 00000000 sonckoad 40808080 + 


SOT8A0 CODRAO «=—90SOOTDS OOSO01DS 0017BIKS 00800000 00000000 00000000 peRacice 80408080 *.6.0,6.0. «+ QUAD * 
$014C0 O60KCO §«=—600500290 00500290 06238108 00800000 00000002 00000000 E2pen9B3 sOecsORO 4.6...6... oe /SQUT . 
501880 C008EG }«6©600278R18 anegCeCO 00009900 00800000 00000002 00000000 E£2cSD9C3 DEéDRROSO +. «o+SBRCOB * 
$01800 00560 00229B3C odcoCeCe do0nsseo 600800000 90000003 00000000 sccScépa 6Re08080 *.. g. -CBFL> * 
501520 600520 00275000 06000000 an00ss00 00800000 00000000 00000000 81818187 81618181 . 5... ce ee Renseececccee  MAAABAAA® 


weeece seaeee 


502580 001860 
$O2RA0 OO1BA0 
502BCc0 001RCO 


scenes aaseee 


SO2P80 001FE0 


67818181 81816761 81816181 81816181 81618161 61816181 COSOO3SAS TAAARAARAAAAAARAABBARRADABARA.6.U* 
G0000CTC 0050038 c0SOters CCO0001Cc 005002C8 005018D8 GOODODIC *.5.8.....6.0U.8.8....-6.8.6.0.-..% 
81819181 81618167 6181818T 01818181 61618187 81878181 8189161601 ARRARRAAAAAAAARABADRARAAARAAARAL® 


BtS181ET BIGISte S1ststet 81618781 G1818TSt SIBIOCOS OCOSOOON *ARAAAADAAAAAAAAABADBAABRAA......* 


Figure 2: Sample Program Run, Map, and Dump 
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Finally, those parts of virtual storage being used by the program are 
displayed. (This does not include the parts of MTS being used by the 
program.) The number at the left hand side of each line is the address of 
the first byte displayed on the line. (At the beginning of a block of 
storage, the first bytes of the line may not be printed.) Each line is 
divided into eight four-byte: (that is, eight hexadecimal digits) words. 


Included here is an example program and the map and dump which it 
produced. Figure 1 shows the assembler output; and figure 2 shows the S$RUN 
command, map, interrupt message, and dump. The program is a subroutine 
named QUAD which takes five arguments. The first. three arguments are 
coefficients A, B, and C of the quadratic equation 


A*X**2+B*X+C=0 


The fourth and fifth arguments contain the real roots of the quadratic 
equation when the subroutine returns. Complex roots are not permitted. The 
object deck for QUAD is in the file QUAD, and there is an object deck for a 
main program (with a blank name) to test QUAD, in the file QUADCALL. Since 
there was a program interrupt, there is obviously an error. The interrupt 
code in the PSW is 6, a specification error. This type of interrupt may be 
caused by an alignment error, an odd register number when an instruction. 
requires an even register number, etc. The Principles of Operation 
summarizes the reasons why each of the interrupt codes might occur. The 
interrupt address in the last three bytes of the PSW is 5002EC. Since 
SO002EC lies between the values 500290 and 501000, the interrupt occurred in 
QUAD. Subtracting the relocation factor for QUAD (which in this case 
happens to be the same as the value) from S002EC gives 5C. In the assembler 
listing, 5C is the address of the SE instruction in statement 38. Since 
this is the instruction after the one being executed at the time of the 
interrupt, the instruction which caused the trouble is in statement 37 
{unless some other instruction branches to statement 38). 


All reasons for a specification interrupt except alignment can be quickly 
eliminated. To check on alignment, it is necessary to compute the address 
from the base, displacement, and index. There is no index and the 
displacement is zero; so the entire address is the contents of general 
register 9. The general register display in the dump shows that register 9 
contains FFFFFFFF. This is certainly not divisible by 4; and therefore, it 
does not produce the proper alignment for a floating-point short instruc- 
tion. Either the contents of the register are wrong or the base specifica 
tion is wrong. The program is supposed to be storing the value of the 
second root. Looking at statement 11 in the assembler listing, it is seen 
that the addresses of the five arguments are in general registers 2 through 
6. Therefore, the address of the fifth argument, which is the storage 
location of the second root, is in register 6, not register 9. Changing the 
instruction in line 37 to 


STE 4,0(,6) 


should correct the problen. 
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Before rerunning the program, the user should check that everything is 
correct up to that point, to avoid the "toss it in, maybe it'll work" 
syndrome. Looking first at register 14, it is seen from the map that 5002DA 
is in QUAD. Subtracting the relocation factor gives 4A. The address 4A in 
the assembler listing is that of the instruction after the call on SQRT. 
Consequently, SQRT was the last subroutine called. SQRT does not produce a 
return code; and therefore, register 15 still has the address of SQRT. 


It can be verified that register 13 points to the save area in QUAD. The 
QUAD save area can be uged to find the save area of the calling progran. 
The convention for the save area is that the second word points to the 
previous save area, that is, the save area of the calling program. Looking 
at location 500358 (which is the address contained in register 13) in the 
dump, it can be seen that the previous save area is at location 500234. 
From the map, this is in the program with a blank name, or in other words, 
the test calling progran. 


Having found the previous save area, the user can now determine what the. 
arguments were for QUAD. Registers 14 through 12 at the time of entry into 
QUAD are stored starting with word 4 of the save area. Therefore, register 
1, which points to the list of argument addresses, is in word 7. ‘This list 
address is 50020C. Looking at 50020C, it is seen that the five argument 
addresses are 500220, 500228, 500228, 50022C, and 500230. To put it another 
way, the value of A is at 500220, the value of B is at 500224, and the value 
of C is at 500228. Checking these locations in the dump shows that 


Az2.0 B=5.0 C==12.0 


At the time of the interrupt, the value of the second root is in 
floating-point register 4. From the quadratic formula, the solutions for 
the above values of A, B, and C are 1.5 and 4.0. The contents of 
floating-point register 4 is <-4.0; and therefore, the second root is 
correct. Likewise, the values of the discriminant and 2A can be verified 
from floating-point registers 0 and 2 respectively. 
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PROJECTACCOUNT 


INTRODUCTION 


PROJECTACCOUNT allows project directors and instructors to distribute 
money, permanent disk space, and terminal and plotting time, as they wish, 
to various signon ID's belonging to their project or class. Also, the 
expiration time for individual signon ID's may be changed. These distribu- 
tions are limited by maximums set for the entire project or class rather 
than having each signon ID with its own relatively fixed maximums. In 
addition, the amounts used and the maximums for any given signon ID may be 
displayed, as well as the amounts allocated compared with the maximums for 
the project and the totals for the project as a whole. 


Before a project can use PROJECTACCOUNT, one of the signon ID's belonging 
to the project must be authorized to use the program. Only one signon ID is 
authorized per project. The authorization and setting of maximums for the 
project and this authorized signon ID can be accomplished by contacting the 
business office at the Computing Center. 


In the examples which follow, it is assumed that the project number is 
G0335006, the signon ID authorized to use PROJECTACCOUNT is $001, and the 
other ID's belonging to the project are S002, S003, and S004. The maxinun 
amount of money for the project is $550, and the maximum and used amounts of 
money for each signon ID are as follows: 


TD MAXIMUM $ USED $ 


$001 100 25 
$002 100 10 
$003 100 125 
soo4 100 0 


The examples follow each other logically; that is, the result of each 
example is presumed to be the starting point for the next example. With the 
exception of the sections where the complete heading is given, the one line 
heading in each example is for convenience only and is not part of the 
actual output. 


The discussion of the commands, signon ranges, and keywords assuses 
operation from a terminal. Batch operation involves only minor differences, 
and a batch job to produce the examples in this section appears at the end 
of this writeup. 


To start the program after signing on to MTS using the authorized signon 
ID for the project, enter the MTS command 
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SRUN *PROJECTACCOUNT 
after the "#" is printed. After execution begins, the program responds with 
MTS ACCOUNTING MAXIMUM MAINTENANCE FOR PROJECT G0335006 


and a question mark prefix is printed indicating that the program is ready 
. for input. 


COMMANDS 


ADDing Money to_a Signon ID 
If $100 is to be added to the maximua charge for S003, enter 


ADD S003, CHARGE=100 


ADD is called the command. A delimiter, which is one or more blanks or 
commas, in any order, aust follicw the command. 100 is called the value of 
the keyword. A keyword and its value are always separated by an "=", The 
combination of the keyword "=" and the value is called a keyword parameter. 
Keyword parameters are separated froma the signon range and from each other 
by delimiters. 


After the $100 has been added to S003, the program responds with 


SIGNON CHARGE DISK SPACE TERM TIME PLOT TIME. EXPIRE 
(DOLLARS) (PAGES) (ARS:MIN) (HRS¢HIN) DATE/TIME 
(MAXIMUM AMOUNT IS ABOVE USED OR CORRENT AMOUNT. NC=NO CHANGE ON.) 


$003 200.00 10 IGNORED IGNORED 12-31-70 
125.00 2 0:00 0:00 24:00 


and another question mark prefix. The first line after the three line 
heading shows the new aaximuns for S003, and the second line shows the 
amount already used ($125). If this is all that is desired, producing an 
end-of-file condition on input terminates execution of the proaras. 


SUBTRACTing Money fros_a Signon ID 
While ADD causes the progras to add the values of the keyword parameters 
to the current saxinums, SUBTRACT causes the program to subtract the values 
of the keyword parameters from the appropriate current naximsums.. To reduce 
the maximun amount of soney for $003 by $10, enter 
SUBTRACT $003, CHARGE=10 


The program responds with = 
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SIGNON CHARGE DISK SPACE TERM TIME PLOT TIME EXPIRE 
$003 190.00 10 IGNORED IGNORED 12-31-70 
125.00 2 0:00 0:00 24:00 


and a question mark prefix. If the result of the subtraction had been 
negative, the maximum for the signon ID would have been set to zero. 


MODIFYing Money for a Sigqnon ID 


MODIFY causes the program to replace the current values of the appropri- 
ate maximums with the values of the keyword parameters. To set the saximun 
amount of money for S002 to $15, enter 


MODIFY S002, CHARGE=15 
The program responds with 
SIGNON CHARGE DISK SPACE TERM TIME PLOT TIME EXPIRE 


$002 15.00 2 IGNORED IGNORED 12-31-70 
10.00 0 2:00 0:00 24:00 


EQUALIZing Money _for_a_ Signon ID 


EQUALIZE causes the program to add the values of the keyword parameters 
to the appropriate current used amounts (as opposed to the current maximums 
for ADD) and replace the corresponding maxinums with the result. Thus, to 
give S003 $25 more than has been used, enter 


EQUALIZE S003, CHARGE=25 
The program responds with 
SIGNON CHARGE DISK SPACE TERM TIME PLOT TIME EXPIRE 
$003 150.00 10 IGNORED IGNORED 12-31-70 
125.90 2 0:00 0:00 24:00 
This command is useful for giving all the students in a class the sane 
anount of money with which to do a new problen, 
EXPIFing Noney_for_a_Signon ID 
The command EXPIRE, without any keyword parameters, is the same as MODIFY 
with the keyword parameters CHARGE=0, DISK=0, TERMINAL=0, PLOT=0, EXPIRE=03- 
01-00, and NOCHANGE=ON. (See the “Keywords" section.) That is, all 


maximums are set to zero, the signon ID is expired, and "no change" is set 
on. Thus 


EXPIRE S002 
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produces 
SIGNON CHARGE DISK SPACE TERM TIME PLOT TIME EXPIRE 
$002 0.00 0 0:00 0:00 07-07-70 
NC 10.00 0 - 2200 0:00 16: 25 


Any keyword parameters given with the command EXPIRE override the values 
of the corresponding implied keyword parameters. Therefore, 


EXPIRE S004,CHARGE=95 


produces 
SIGNON CHARGE DISK SPACE TERE TIME PLOT TIME EXPIRE 
soo 95.00 0 0:00 0:00 07-07-70 
nc 0.00 0 0:00 0:00 163 25 


Note that NOCHANGE=OFF does not override NOCHANGE=ON. (See the section 
“Changing NOCHANGE®.) 


Obtaining the STATUS _ of a Signon ID 


The command STATUS enables cne to print the maximum and used agounts for 
a signon ID. 


STATUS S001 


produces 
SIGNON CHARGE DISK SPACE TERM TIME PLOT TIME EXPIRE 
$001 100.00 0 IGNORED IGNORED 1231-70 
25.00 0 0:00 0:00 24:00 


Note that these are the asounts as of the last signoff of the signon ID. 
All keyword parameters except HEADING are ignored by STATUS. See also the 
section "PROJECT". 


CONTINGing with a Different Signon ID 


The command CONTINUE, without any keyvord parameters, does the same thing 
as the previous command bat uses the new signon range. It does not produce 
a new heading unless the keyword HEADING (see the section "Producing a 
HEADING") is explicitly used with the CONTINUE command. Thus if 

ADD S002, CHARGE=5, NOCHANGE=0 FF 


which produces 
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SIGNON CHARGE DISK SPACE TERM TIME PLOT TIME EXPIRE 
$002 5.00 0 0:00 0:00 07-07-70 
10.00 0 2300 0:00 16325 


is followed by 
CONTINUE S004 


the program responds with 
SIGNON CHARGE DISK SPACE TERM TIME PLOT TIME EXPIRE 


S00u 100.00 0 0:00 0:00 07-07-70 
0.00 0 0:00 0:00 16:25 


Any keyword parameters given with CONTINUE override the corresponding 
keyword parameters used with the previous command. Thus, after the above 
sequence of ADD and CONTINUE 

CONTINUE S002,CHARGE=10 
produces 
SIGNON CHARGE DISK SPACE TERM TIME PLOT TIME EXPIRE 
$002 15.96 0 0:00 0:00 07-07-70 
10.00 / 9 2:00 0:00 16: 25 


Note that NOCHANGE=OFF does not override the keyword parameter NOCHANGE=ON. 
(See the section "Changing NOCHANGE".) 


The command PASSWORD enables project directors to display the current 
password for any signon ID belonging to the project. To display the 
password for S004, enter 

PASSWORD S004 
to produce 
SOC& PASSWORD IS X95MPS (E7F9FS5SD4D7E2) 


The characters in parentheses are the hexadecinal representation of the 
password. 


All keyword parameters are ignored by PASSWORD. Also, unlike other 


commands, PASSWORD must be specified for a single Ip. Any attempt to use a 
block or ENTIRE as the signon range causes an error message to be printed. 
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OTHER SIGNON RANGES 


Blocks 


So far, the signon range has been a single signon ID. It may, hovever, 
refer to a group of signon ID's. For a specific, contiguous block of signon 
ID's belonging to the project, the signon range is the first signon ID 
followed by a delimiter, three dots (periods), an optional delimiter, and 
the last siqnon ID. For exauple, 


STATUS S002,...,S004 


produces 

SIGNON CHARGE DISK SPACE TERM TIME PLOT TIME EXPIRE 

5002 15.00 0. 0:00 0:00 07-07=70 
10.00 0 2:00 0:00 16:25 

5003 150.00 10 IGNORED IGNORED 12-31-70 
125.00 2 0:00 0:00 24:00 

5004 100.00 0 0:00 0:00 07-07-70 
0.00 0 0:00 0:00 16:25 


The incrementing of signon IQ*s within a block is defined as the collating 
sequence for the IBM 360 gomputer, that is, alphabetic letters come before 
the numbers 0 through 9. The first signon ID should be less than or equal 
to the last signon ID. 


ENTIRE 


If all of the signon ID*s for the project are desired, the word ENTIRE 
may be used for the signon range. For example, 


MODIFY SOOT, ROCHANGE=0N 
SUBTRACT ENTIRE ,CHARGE=10 


produces 

SIGNON. CHARGE DISK SPACE TERM TIME PLOT TINE EXPIRE 

$002 5.00 . o 0:00 0:00 07-07~70 
10.00 0: 2:00  0r00 16:25 

$003 180.00 10 IGNORED IGNORED 12-31-70 
125.00 2 0:00 0:00 28:00 

soos 90.00: o 0:00 0:00 07-0770 
0.00 | oo 0:00 0:00 16:25 
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Note that S001 is not listed. The MODIFY command which sets NOCHANGE to 
ON is used to prevent money from being subtracted from the master signon. 
This is usually desirable as the master signon should only be used for 
running *PROJECTACCOUNT. 


PROJECT 


The above signon ranges can be used with any command. PROJECT can be 
used only with STATUS. Entering 


STATUS PROJECT 


produces 
SIGNON CHARGE DISK SPACE TERM TIME PLOT TIME EXPIRE 
PRJ 550.00 50 IGNORED _IGNORED 12-31-70 
340.00 10 2:00 0:00 24: 00 
REM 210.00 40 IGNORED IGNORED 
52.5C 10 0:00 0:00 
ToT 335.00. 10 0:00 0:00 
160.00 2 2:00 0:00 


NOCHANGE ON FOR 1 AND OFF FOR 3 OF THE 4 PROJECT ID'S 


This listing needs some explanation. The first line, labeled PRJ for 
"PROJECT", shows the maximums for the project. Note the $550 under charge. 
The second line shows the cumulative amounts for the project. Since MTS 
permits a user to finish, once he is signed on, a maximum may be less’ than 
the corresponding used or current amount. This same condition can also be 
produced by using PROJECTACCOUNT. Therefore, the cumulative amounts for the 
project are computed by summing the larger of the maxinum and used or 
current amounts for each signon ID. (See also "Miscellaneous" regarding 
disk space.) Referring to the listings in the sections "Changing EXPIRation 
Time" and "ENTIRE", the cumulative amount of money is computed as follows: 
the larger of the maximum and used amounts for S001 is $100. The larger 
amount for S002 is $10, and the larger amounts for S003 and sO04 are $140 
and $90, respectively. Adding these amounts together produces the sum of 
$340, 


The third line, labeled REM for "REMAINING", shows the results of 
subtracting the cumulative amounts (second line) from the maximums (first 
line) for the project. fJhese differences are the amounts which can still be 
distributed to the signon ID's belonging to the project. In this case, 
$550-$340=$210 can still be added to individual signon ID's. The fourth 
line shows the amounts which shculd be added to each signon YD with "no 
change" currently off (see "Changing NOCHANGE") in order to evenly distri- 
bute the remaining amounts. That is, the values in the fourth line are the 
results of dividing the values in the third line by the number of ID's with 
"no change" off ($210/8=$52.50). Note that fractional of negative amounts 
cannot be used as keyword values. 
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The fifth line, labeled TOT for "TOTALS", shows the sums of the saxiauars 
for the signon ID's. Thus, the sum of the maximums of $100, $5, $140, and 
$90 for S001 through S008 is $335. The sixth line shows the sums of the 
used or current amounts for the signon ID's. 


The seventh line states the number of signon ID's with ‘no change" on, 
the number of signon ID's with "no change" off, and the number of signon 
ID's belonging to the project (four in this case). 


KEIWORDS 


Changing Naxinua CRARGE 


The keyword CHARGE has been shown to specifiy changes in dollars of the 
maximums amount of money permitted to a signon ID. Other keywords are used 
to specify other maximums and control functions. ALl keyword parasgeters 
come after the signgn range and may be listed in any order. They are 
separated from the signon range and from each other by delimiters. All 


numeric keyword values sust be entered as unsigned integers without decimal 


points, that is, there may be no fractional or negative keyword values. 
The keyword DISK (or FILE) is used to specify changes in pages of the 
maximum disk space permitted to a signon ID. To add 5 pages of disk space 


to $003, entering 


AID S003, DISK=5 


produces 
SIGNON CHARGE DISK SPACE TERM TIME PLOT TIME EXPIRE 
$003 440.00 15 IGNORED IGNORED 12-31-70 
425.00 2 0:40 0:00 24:00 


The second line of the listing under DISK SPACZ is the amount of disk 
space (2 paqes) currently being used by $003. 
Changing Maxiaua TEPNINAL Tise 
Minutes 
The keyword TERMINAL is used to specify changes in minutes of 


maximum terminal time peragitted to a signon ID. To restrict S002 to 
two and a half hours of terminal time, entering 


390 Projectaccount 


MTS Volume 1: MTS =~ The S 
April 1974 
MODIFY S002, TERMINAL=150 
produces 
SIGNON CHARGE DISK SPACE TERM TIME PLOT TIME EXPIRE 
$002 5.00 0 2:30 0:00 07-07-70 
10.00 0 2:00 0:00 16: 25 


If the project is permitted unlimited terminal time, subject on 


ystenm 


ly to 


available funds, signon ID's belonging to the project may also be 


permitted unlimited terminal time. Unlimited terminal time is 
cated in the listing by the word IGNORED in place of the max 
Unlimited terminal time may be set by using the word IGNORE as 
value of the keyword TERMINAL. Thus to give S002, unlimited ter 
time, entering 


MODIFY S002, TERMINAL=IGNORE 


produces 
SIGNON CHARGE DISK SPACE TERM TIME PLOT TIME EXPIRE 
$002 5.09 0 IGNORED 0:90 07-07-70 
10.00 0 2:99 0:00 16:25 


When the value is IGNORE, the behavior is the same for each of 
commands ADD, EQUALIZE, EXPIRE, MODIFY, and SUBTRACT. Also 


indi- 
inun. 

the 
minal 


the 
, the 


maximum terminal time is set to zero for purposes of the line labeled 


TOT produced by STATUS PROJECT and the commands ADD and SUBTRACT. 


Hours 


The keyword TERMHRS is used to specify changes in hours of maximun 
terminal time permitted to a signon ID. To restrict S002 to 2 hours of 


terminal time, entering 
MODIFY S002, TERMHRS=2 


produces 


SIGNON CHARGE DISK SPACE TERM TIME PLOT TIME EXPIRE 
$002 5.00 0 2:00 0:00 07-07-70 
10.00 0 2:00 0:00 16:25 


IGNORE may also be used as a value for the keyword TERMHRS. 
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Changing Saximum PLOTting Tise 
Minutes 
The keyword PLOT is used to specify changes in minutes of maxinua 


plotting tise permitted to a signon ID. To give S003 an hour and 45 
minutes of plotting time, entering 


MODIFY S003, PLOT=105 


produces 
SIGNON CHARGE DISK SPACE TERM TIME PLOT TIME EXPIRE 
S003 740.00 15 IGNORED 1385 12-31-70 


125.00 2 0:00 0:00 24:00 
If the project is permitted unlimited plotting time, subject only to 
available funds, the word IGNORE may be used as the value of the 
keyword PLOT. For exauple, 


MODIFY S003,PLOT=IGNORE 


produces 
SIGNON CHARGE DISK SPACE TERM TIME PLOT TIME EXPIRE 
S003 140.00 15 IGNORED IGNORED 12-31-70 
125.00 , 2 0:00 0:00 24: 00 


See also the analogous discussion of unlimited terminal time above. 
Hours 
The keyword PLOTHRS is used to specify changes in hours of nmaxinun 
plotting time permitted to a signon ID. To give S003 one hour of 
plotting time, entering 


MODIFY S003, PLOTHRS=1 


produces 

SIGNON CHARGE DISK SPACE TERM TIME PLOT TINE EXPIRE 

$003 140.00 1& IGNORED 1:00 12-31-70 
125.00 2 0:00 0:00 24:00 


IGNORE may also be used as a value for the keyword PLCTHRS. 


changing BXPTBation Ti 


The keyword EXPIRE is used to specify changes in the expiration time of a 
signon ID. The value of EXPIRE say be either of two forms. 
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Date 


The form MM-DD-YY 
where MM is the two digit month, 
DD is the two digit day of the month, 
and YY is the two digit year, 


is used to set the expiration time to 12:00 p.m. of the specified 
date. For example, 


MODIFY S003, EXPIRE=12-07-70 


produces 


SIGNON CHARGE DISK SPACE TERM TIME PLOT TIME EXPIRE 
$003 140.00 15 IGNORED 1:00 12-07-70 
125.00 2 0:00 0:00 24:00 


Time 
The form MM-DD-YY/hh: ma 


where MM-DD-YY is explained above, 


is the two digit hour in twenty-four hour 
notation, 
and nm is the two digit ninutes, 


is used to set the expiration time to a particular minute of the 
specified date. For example, 


MODIFY S002, EXPIRE=11-°23-70/16:45 


produces 
SIGNON CHARGE DISK SPACE TERM TIME PLOT TIME EXPIRE 


$002 5.00 0 2:00 0:00 11-23-70 
10.00 0 2:00 0:90 16345 


and $002 will not be able to sign on after 4:45 p.m. on November 23, 


1970. Note that the expiration date and time may not be set to a value 
earlier than the current date and time. 


Note that leading zeros must be supplied for the two digit items when 
there is only one significant digit. Also, the keyword EXPIRE behaves as 


though it were used with MODIFY, even when used with ADD. EQULIZE. oF 
SUBTRACT. That is, 


ADD S002,CHARGE=5 ,EXPIRE=11=23-70/16:45 


and 


SUBTRACT S002,CHARGE=5, EXPIRE=11=23-70/16: 45 
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have the same effect on the expiration time as the above example but the 
effect on the maxiaun amount of money is quite different in each case. 


If an attempt is made to expire a signon ID before both the current tine 
and the current expiration time, the earlier of these two times is used as 
the expiration tise. Thus, 


MODIFY S004,EXPIRE=09-01-69 


produces 
SIGNON CHARGE DISK SPACF TERM TIME PLOT TIME EXPIRE 
soo4 90.00 0 0:00 0:00 07-07-70 
0.00 0 0:00 0:00 16: 25 


when the current time is 4:25 p.m. on July 7, 1970. 


If a signon ID is expired, po charge is made for file space belonging to 
that signon ID after the expiration tise. in return, the right to destroy 
the files belonging to expired signon ID's is reserved by the Computing 
Center. However, the file space is still considered to be part of the 


2 
cumylative file space for the protect until it is actually destroyed. If 
the expiration time of the signon ID is set to a later time before the file 


space is destroyed, the project is charged for all file space used during 
the previously expired tine. 


The fact that a signon ID is expired has no effect on the changing of 
maximums by PROJECTACCOUNT. The expiration date and time may not be changed 
for the master signon ID. 


Changing NOCHANGE 


When using a block or ENTIR® for the signon range with any command except 
STATUS, certain signon ID's within the range may not. be changed. If a 
signon ID has “no change" on, it is ignored by the command and no listing 
line is produced for it. The keyword NOCHANGE is used to specify the status 
of "no change". The words ON or OFF may be used as the value of the 
keyword. To have S003 ignored by commands that produce changes, entering 


MODIFY 5003,NOCHANGE=ON 


produces . 
SIGNON CHARGE DISK SPACE “PERM TIME PLOT TIME EXPIRE | 
$003 140.00 15 IGNORED 1:00 12-07-70 
NC 425.00 2 0:00 0:00 24:00 


Note that the letters NC under the signon ID indicate that "no change" is 
on. Now entering ; 
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EQUALIZE ENTIRE, DISK=2 


produces 


SIGNON CHARGE DISK SPACE TERM TIME PLOT TIME EXPIRE 


$902 5.00 2 2:00 0:00 11-23-70 
10.00 0 2:00 0:00 16: 45 

so0u 90.00 2 0:00 0:00 07-07-70 
0.00: 0 0:00 0:00 16:25 


and entering 
STATUS S003 
which produces 
SIGNON CHARGE DISK SPACE TERM TIME PLOT TIME EXPIRE 
s003 140.00 15 IGNORED 1:00 12-07=+70 
Nc 125.00 2 0:00 0:00 24:00 
verifies that S003 was not changed. 
To change S003, 
MODIFY $003, NOCHANGE=OFF 
turns off "no change" and produces 
SIGNON CHARGE DISK SPACE TERM TIME PLOT TIME EXPIRE 
$003 140.00 15 IGNOFED 1:00 12*07=70 
125.00 2 0:00 0:00 24:00 
To change the maximums for a signon ID which has "no change" on and leave 
"no change" on at the end of the operation, the keyword parameters 


NOCHANGE=ON and NOCHANGE=OFF should both appear. For example, 


ADD S003, NOCHANGE=ON, NOCHANGE=0FF, DISK=2 


produces 
SIGNON CHARGE DISK SPACE TERM TIME PLOT TIME EXPIRE 
$003 149.00 17 IGNORED 1:00 12-07-70 
NC 125.00 2 0:00 0:09 24:00 


Note that the order of the keyword parameters makes no difference. 


NOCHANGE behaves the same with any command except STATUS, which ignores 
it. It can be used to inhibit the changing of a signon ID which is not 
currently being used. A fecommended aethod of expiring a signon ID, for 
example S004, is to first destroy all files belonging to the signon ID, and 
then enter 
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MODIFY S008&,CHARGE=0,DISK=0,TERMIWAL=0, EXPIRE=03-01-00,NOCHANGF=ON 


to produce 
SIGNON CHARGE DISK SPACE TERM TINE PLOT TINE EXPIRE 
$004 0.00 0 0:00 0:00 07-07-70 
NC 0.00 0 0:00 0:00 16:25 
Note that this is the same as entering 
EXPIRE s008 


after destroying the files. 


Producing NOLISTing 


fo not print a listing line for each signon ID, the inclusion of the 
keyword NOLIST suppresses printing for that command only, NOLIST does not 
require a value. For example, 


ADD S002,CHARGE=15,NOLIST 


Producing_a_ HEADING 


To produce a heading at the top of a new page befpre printing the next 
listing line, the keyword HEADING should be included with the command. Por 
example, 


STATUS S002,HEADING 
produces 
SIGNON CHARGE DISK SPACE TERM TIME PLOT TIME EXPIRE 
(DOLLARS) (PAGES): (HRS:BIN) (HRS:MIN) DATE/TIME 
(MAXIMUM AMOUNT IS ABOVE USED OR CURRENT AMOUNT. NC=NO. CHANGE ON.) 


$002 20.00 2 2200 0:00 11-23-70 
10.00 0 2:00 0:00 16:45 


HEADING and NOLIST are the only keywords which do not require a value. 


BISCELLANEOUS 


A signon ID cannot be changed while it is signed on to the computer (with 
the exception of the: master signon ID}. If an attempt is made to change a 
signon ID while it is in use, an appropriate comment is printed and thie 
change must be made at a later tise. 
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The value of a maximum for a signon ID can always be reduced. However, 
if an increase in the value of a maximum would cause the cumulative for the 
project (second line produced by STATUS PROJECT) to exceed the maximum for 
the project, the increase is not permitted. Thus, it may be possible to 
subtract a given amount from a signon ID and impossible to add the same 
amount back because the cumulative for the project originally exceeded the 
project maximun. 


Tf an attempt to change the maximums for a signon ID causes an error, the 
maximums are not changed, no listing is produced for the signon ID, and an 
appropriate error comment is printed. 


An attention interrupt causes a question mark prefix to be printed 
indicating that the program is ready for the next input line. If a signon 
ID is being processed at the time of the interrupt, the processing is 
completed before the interrupt takes effect. 


The used amount of money in the listing includes charges for file storage 
to the current time. 


It is not necessary for a project maximum to be represented completely by 
the corresponding signon ID maximums, that is, the project maximam may be 
greater than the sum of the corresponding signon ID maxinuns. If this is 
the case, to increase the maximum for a signon ID, merely enter the 
appropriate input line (with the provision that the new maximum does not 
cause the cumulative for the project to exceed the project saxinum). 


The project cumulative for file space is computed as described in the 
section "PROJECT" with one exception for compatability with MTs. Before 
computing the maximum of the maximum and current space for each signon ID, 
the value to be used for current space is reduced by the smaller of 16 pages 
and the truncated integer result of dividing the maximum space by 8. For 
example, if the maxinum is 7 pages, the value of the current space is used; 
if the maximum is 8 pages, the value to be used for current space is reduced 
by 1 page; and if the maximum is greater than or equal to 128 pages, the 
value to be used for current space is reduced by 16 pages. 


ABBREVIATIONS 


Both commands and keywords may be abbreviated. Only the first three 
letters of the command are necessary; minimum abbreviations for commands and 
keywords are underlined in the summary below. 


Thus, the last example in “Changing NOCHANGE" can be expressed more 
concisely as 


MOD S004,C=0,D=0,T=0, P=0, E=03-01-00, NC=ON 
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SUMBARY OF INPUT EF 


Zaput Lines 
The form of the input line, using standard notation, is 


cr q c . 
{[b]... < STATUS > d < signon-range > [ad HEADING] [@]} (3; comment] 
{ 


( 1 | PROJECT . 
t 4 & ! 4 

or 
c vv 
{ ADD ( 

[bj]... < EQUALIZE > d signone-range keyword... (4) [; comment] 

| SODIFY 
{ SUBTRACT | 
t 4 

or 


c 4 
[bd]... < CONTINUE > d signron-range [keyword]... [4d] [; comment] 

{ EXPIRE | 

t 


| 


or 


{b]... {PASSWOPD} ad signon [4] [; comment ] 


Where dis CBf,} eee 
er q % 
( ( CHARGE t t 
{ | DISK{FILE | { 
| | EXPIRE | i 
{ < NOCHANGE > =value | 
keyword is a< | oT { > 
{ | BLOTTERS { ! 
( | ZERMYFS { { 
t | ZERBIWAL |f 1 
Ee 4 t 
{ HEADING 1 
| No,Ist t 
t t 
t + 


| NOHEAD 
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signon-range is 
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e 
{ signon 
< signon d... {d] signon 


{ ENTIRE 
a 


tome Yaw 


b is a blank or space, 

doce is a delimiter followed by three dots 
(periods), 

0 indicate a compulsory choice of one 
line, 

1 indicates a compulsory choice of one 
elenent, 

| indicate an optional choice, 

eos (not ad...) indicates an optional (0 or 
greater) number of repetitions of the 
preceding element, 

lower case letters indicate a type of element to be used, 

and all other characters are to be used exactly as shown. 


Comments may 


at the end of the input line and must be separated 


from the last parameter by a semi-colon. 


Commands 


Comnand 


ADD 


CONTINUE 


EQUALIZE 


EXPIRE 


MODIFY 


PASSWORD 


Function 


Adds the values of the keyword parameters to _ the 
current maximums to produce the new maximums. 


Produces the same action as the previously entered 
command but uses the new signon range and any new 
keyword values explicitly specified. 


Adds the values of the keyword parameters to the 
used or current amounts to produce the new 
maximums. 


Substitutes zero for the current maximums and sets 
the expiration time to the current time unless 
other keyword values are explicitly specified, and 
sets "no change" on. 


Substitutes the values of the keyword parameters 
for the current maximums. 


Enables project director to display current pass- 
word for any signon ID belonging to the project. 
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STATUS Lists the current values of maxinum and used or 
current amounts. 
SUBTRACT Subtracts the values of the keyword parameters froa 
the current saximuas to produce the new maxiauas. 
Keyyords 
Keyword Reference Value Units 
CHARGE Money Dollars 
(DISK|FILE] Disk Space Pages 
| EXPIRE Expiration Time MM-DD-YY 
| MM-DD-¥Y/hh: ae 
HEADING Listing Heading none 
NOHEAD Listing Heading none 
NOCHANGE No Change ON 
OFF 
NOLtIst Listing none 
PLOT Plotting Tine Minutes 
IGNORE 
PLOTHRS Plotting Time Hours 
IGNORE 
TERSHRS Terninal Tine Hours 
IGNORE 
TERN INAL Terminal Tine Minutes 
IGNORE 
Teraination 
An end«of-file on input tersinates 


execution. 


Logical 1/0. Unit Hanes 


SCARDS =~ Input 
SPRINT ~ Listing 
SERCOM ~ Error Comments 
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Batch Input to Produce Examples_in this section 


SSIGNON SOO1 © PROJFCT DIRECTOR! 
PASWRD 

SRUN *PROJECTACCOUNT 

ADD S003,CHARGE=100 

SUBTRACT S003,CHARGE=10 

MODIFY S002,CHARGE=15 

EQUALIZE S003 ,CHARGE=25 

EXPIRE s002 

EXPIRE SO00&%,CHARGE=95 

STATUS S001 

ADD S002,CHARGE=5 , NOCHANGE=OFF 
CONTINUE soo4 

CONTINUE S002,CHARGE=10 

PASSWORD S004 

STATUS S002,...,S5904 

MODIFY S001,NOCHANGE=ON 

SUBTRACT ENTIRE, CHARGE=10 

STATUS PROJECT 

ADD S$003,DISK=5 

MODIFY S002, TERMINAL=150 

MODIFY S002, TERMINAL=IGNOFE 
MODIFY $002, TEPMHRS=2 

MODIFY S003, PLOT=105 

MODIFY SC03,PLOT=IGNORE 

MODIFY S003, PLOTHRS=1 

MODIFY S003, EXPIRE=12-07=70 
MODIFY S002, EXPIRE=11-23—-70/176:45 
MODIFY SOO4, EXPIRE=09=-01= 69 
MODIFY S003, NOCHANGE=ON 

EQUALIZE ENTIPE, DISK=2 

STATUS S003 

MODIFY S$003,NOCHANGE=OFF 

ADD S003, NOCHANGE=ON, NOCHANGE=OFF, DISK=2 
MODIFY S004,C=0,D=0,T=0,P=0,£=03-01-00,NC=0 
ADD S092,CHARGE=15,NOLIST 

STATUS S002, HEADING 

S2NDFILE 
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GLOSSARY OF COMPUTING TERNS 


This glossary is meant to be used as an aid in interpreting the computing 
terms that are used in the documentation produced by the Computing Center. 
This section attempts to define the normal use of each term and favors’ the 
"everyday" interpretations over the more technical descriptions. 


All terms given in the first line of each entry, and separated by commas, 
are considered synonyas. 


Bach entry is given a code which is meant to give some indication of the 
scope of the definition. The codes have the following seanings: 


GC The term and definition is widely used in the computing field 
(GC = General Cogputing). 


360 The term and definition is valid in the context of the IBM 360 
(and probably 370) series of computers, but not necessarily 
anywhere else. 


MTS The term and definition is valid in the context of the MTS 
' operating systen. 


wso The term and definition is applicable only to the Wayne State 
University Computing and Data Processing Center. 


Abend, Abnormal End 360 


An erroneous or incorrect program termination, indicating programming 
or data problems. 


Address ele 


An identification, as represented by a name, label, or number, for a 
register or location in storage. 


*AFD* MTS 
A pseudo device name referring to the currently active file or device. 
It is the file or device obtained by a GET, CREATE, or EDIT command, to 
which MTS writes (or from which it reads) data lines when in MTS 
command mode. 

Algorithna GC 
A prescibed set of well-defined rules or processes for the solution of 


a problema in a finite number of steps; for example, a full statement of 
an arithmetic procedure for evaluating “sin x" to a stated precision. 
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Alphanumeric, Alphameric GC 
Pertaining to a character set that contains both letters and digits. 

American Standard Code for Information Interchange, ASCII GC 
A character transmission code for use between a terminal device and a 
cornputer. Each character is uniquely represented by a 7-bit number 
with an eighth bit generated for parity. The parity bit is used as a 
check bit. 

APL . Gc 
A Programming Language; a conversational prograaming language which is 
best suited for problems requiring extensive manipulation of a small 
amount of data. 

Application Package GC 
A set of programss and/or sub-programs designed to aid in the solution 
of a specific class of problems; for example, the IBM package SSP 
(Scientific Subprogram Package) is designed to provide support for 
numerical and statistical progrars. 

Arguaent GC 
A parameter explicitly passed from a calling program to a called 
program (subroutine); for example, in the FORTRAN statement CALL 
SUB(A,8,C), the variables A, B, and C are arguments to be passed to the 
subroutine SOB. 

. Array 6c 
An arrangerent of elerzents in one or more dimensions. 

ASCII = See American Standard Code for Information Interchange. 6c 

Assenble GC 
To prepare a machine language programa from a low-level symbolic 
language fassenbler language) program by substituting absolute opera- 
tion codes for symbolic operation codes and absolute or relocatable 
addresses for sysbolic addresses. 

Asseabler Gc 


A programa that converts low-level symbolic language progrags into 
machine code. 


360-assermbler Language 360 
A low-level symbolic progressing language used to write progrars for 
the IBM 360 series of computers. See also Asserble and Asseabler. 
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Auxiliary Storage, Secondary Storage GC 


Data storage other than main storage; for example, storage on magnetic 
tape or direct access devices. In general, any storage that supple- 
ments another storage is auxiliary. See also main storage. 


Backspace GC 


To move backward one or more characters or records; for example, if an 
input device (such as magnetic tape) is positioned to read the ath 
record, a backspace of one record positions the device to read record 


art. 
Base Address 360 


An address used as a base to compute a storage location. Instructions 
which refer to a storage location do so by specifying a register and a 
12-bit displacement address. The register contains a 24-bit (or 
32-bit) base address. The actual storage location referenced is given 
by the sum of the base address and the displacement. See also Base 


Register. 

Base Register 360 
Any general register used to hold a base address. See also Base 
Address. 

Batch Processing GC 


A form of computer job processing in which the jobs (usually in the 
form of card decks or card images) are submitted to a central location 
where they are queued, either manually or automatically, for execution 
at a later time. There is no possibility of interacting with a batch 
job. See also HASP. 


Batch Queue, Batch Strean Gc 


In batch processing, the queue in which computer jobs await execution. 
See also Batch Processing, HASP. 


Binary GC 
(1) Pertaining to the number system with the base of two. 
(2) Pertaining to a characteristic or property involving a selection, 
choice, or condition in which there are only two possibilities. 


Binary Code GC 


A code that makes use of exactly two distinct characters, usually 0 and 


e 
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Binary Coded Decimal, BCD ; GC 


A character code which represents each character uniquely in 6 binary 
digits. Hence, there are 64 characters possible within the encoding. 


Binary Digit, Bit . GC 


One of the digits (0 og 1) of the binary number system. This term is 
usually contracted to "bit" in computer terminology. 


Binary Forsat GC 


A term referring to “unforsatted" I/O in FORTRAN programs; for exaasple, 
the format of the output from the FORTRAN statement WRITE (4) X,Y¥,2Z. 
“Unformatted” is the preferred terminology. 


Binary Read Feature : 360 


A feature on 4a card reader that allows the reading of column binary 
cards, that is, cards with non-EBCDIC punches within any or all 
coluans. 


Binary Search GC 


An efficient amethod of searching an ordered table, in which the 
midpoint of the table is examined and one half is rejected as not 
containing the elements desired. The process is repeated on the half 
containing the elerents. Successive bisection of the table quickly 
isolates the desired elements. This method is also known as the 
half-interval search. a 


Bit = See Binary Digit. | 6c 
Block = See Physical Record. GC 
Blocking GC 


The process of combining two or more logical records into one physical 
unit (physical record) so that it can be written to or read from an 1/0 
device in a single operation. 

Blocking Factor 6c 


The nusber of logical records combined to make one physical record. 
See also Blocking. : , 


BPI (bits per inch) - See Magnetic Tape Density. GC 
Buffer : eu * ox _ 6c 
A temporary storage region for data being transmitted from one unit to 


another; for example, from a central processor to an 1/0 unit. The 
purpose of the buffer is to compensate for the different speeds at 
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which the units can handle data. Sometimes a buffer is a permanent 
hardware feature of the unit (for example, as in a “buffered printer") 
and sometimes internal main storage areas are assigned temporarily to 
act as buffers. 

Bug 6C 
A mistake in a program which causes a malfunction. 

Byte 360 
A sequence of 8 adjacent binary digits (bits) which can be addressed 
and operated on as a unit. A byte is the smallest addressable unit of 
storage in the IBM 360 series of computers. 

CALCOMP Plot 6c 


A diagram produced by a CALCOMP plotter. See also cCALCOMP Plotter, 
Digital Incremental Plotter, Plotter. 


CALCOMP Plotter 6c 


A plotter manufactured by California Computer Products, Inc. See also 
Digital Incremental Plotter, Plotter. 


Called Progran GC 


The routine to which a calling program transfers control. See also 
Calling Progran. 


Calling Program 6c 
The routine from which a routine has been called. See also Called 
Progran. 

Calling Sequence GC 


A specified arrangement of instructions and data necessary to transfer 
information and control to a routine. 


Card, Computer Card, Punched Card GC 
A card which can be used as a computer input or output medium. There 
are various sizes and shapes of cards, the most common having 80 
columns and measuring 7 3/8 x 3 1/4 inches. 


Card Column GC 


The most common computer card has 80 vertical columns numbered from 1 
to 80 from left to right. Each column is divided into 12 punching 
positions and can be used to contain the coded representation of an 
alphanumeric character. The code is a series of punched holes. 
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Card Deck, Deck GC 


A collection of punched cards comprising prograas.and/for data for a 
computer run. a : 


Card Hopper, Hopper GC 


A holder into which cards are placed, and from which they are fed to 
the punching or reading mechanism of a card punch or reader. 


Card Image GC 
A one-to-one representation of the contents of a computer card; for 
example, a magnetic tape containing one-to-one copies of the cards ina 
card deck is said to contain card images. ‘ 

Card Punch GC 
A peripheral unit for punching computer cards. See also Keypunch. 

Card Reader GC 
A peripheral unit for reading computer cards. 


Card Stacker GC 


A holder into which computer cards are accumulated into a deck after 
they have been either read or punched. 


Carriage Control Character GC 
A character, nora#ally the first in an output record, which is used to 
control the vertical spacing of printed output and is not itself 
printed. See also Logical Carriage Control, Machine Carriage Control. 

Cathode Ray Tube, CRT 6c 
An electronic tube in which a beam of electrons can be controlled and 
directed by an electronic lens so as to produce a visible display of 
inforrmation on the surface of the tube. The IBM 2269 Display Statior 
terminal and the Tektronix 4010 Storage Tube terszinal use CRT‘s. 

Ccid . MTS 
A 4echaracter identification code assigned to each user of the MTS 
systen. The ccid serves to identify the user's account. It is also 
referred to as a “signon id". 

Central Processing Unit, CPU, Central Processor GC 
The unit in any digital coagputer systes which coordinates and controls 


the activities of all the other units and perforas all the logical and 
arithmetic processes to be applied to data. 
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Character GC 


A letter, digit, or other symbol that is used as part of the 
representation of data. 


Character Code . 6C 
A numeric code assigned to characters so that they may be represented 
in the memory of digital computers. See also Binary Coded Decimal, 
Collating Sequence, Extended Binary Coded Decimal Interchange Code. 

Character String GC 
A sequence of characters. 


Checkpoint GC 


A place in a program where a check, or a recording of data for restart 
purposes, is made. 


Closing a File MTS 
The process of causing all main storage buffers containing parts of the 
file that were changed to be written to the file, and then causing all 
buffers and control blocks associated with the file to be released. 

COBOL GC 


Common Business Qriented Language; a procedural language designed for 
commercial data processing. 


Code 6c 
(1) A set of unambiguous rules specifying the way in which data may be 
represented. 
(2) To write a program. 
Collate GC 


To compare and merge two or more similarly ordered sets of items into 
one ordered set. 


Collating Sequence ec 
An ordering assigned to a set of characters, the ordering being 
determined by a numeric code assigned to each character. See also 
Character Code. 

Collator GC 


A machine used to merge two indevendent card decks which have been 
sorted into collating sequence. 
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Coluan - See Card Colunn. Gc 
Colurgn Binaty 6c 


Pertaining to the binary representation of data on computer cards in 
which adjacent positions in a column correspond to adjacent binary 
digits. Loosely, and sore understandably, any nonestandard, that is, 
non-EBCDIC, card punch sequences. See also Binary Read Feature. 
Command Language Gc 


The set of commands which interface the computer user with the computer 
system, for example, the MTS comsands. 


Command Line MTS 


An input record containing a command, such as an MTS command, debug: 
command, edit command, etc. 


Command Mode - See MTS Comaand Node. MTS 

Comgon Storage Area 6c 
Usually, main storage which can be shared by several routines. 

Compilation Time GC 
(1) \The length of time it takes to translate a program from the source 

language into machine language. 
(2) The time during which a program is being compiled. 

Compile GC 
To translate a program. written in a high lewel Ianguage (for example, 
FORTRAN, ALGOL, PL/I) into an equivalent machine language program which 
hay subsequently be executed. 

Compiler GC 
A progran which converts a high level language (for example, FORTRAN, 
ALGOL, PL/I) into a lower level language, usually machine language. A 
compiler normally generates several low level instructions for each 
source language statement. In addition, most compilers allow the 
programger to incorporate sub-programs from a program library. 

Completion Code 6C 
A return code from a language processor which indicates whether any 
serious errors were encountered and, if so, how serious they were. See 
also Return Code. 


Computer Card - See Card. GC 
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Computer Graphics, Graphics GC 


Any form of drawing, (for example, maps, graphs) produced under 
computer control. The term is sometimes generalized to include any 
form of visible computer output, thereby including printed output as 
well as display on CRT screens. See also Calcomp Plotter, Digital 
Incremental Plotter, Plotter. 


Computer Word = See Fullword. GC 

Concatenate MTS 
To connect two or more sets of information, such as strings or files, 
in sequence, such that they can be treated as a single unit. See also 
Explicit Concatenation, Implicit Concatenation. 

Console - See Operator's Console. 6C 

Console Typewriter GC 
A unit of the operator's console through which communication between 
the operator and the operating system takes place. Console typewriter 
messages include those informing the operator of some required action, 
for example, tapes requiring mounting, and those informing the operator 
about the status of the programs currently running. See also Opera- 
tor's Console. 

Continuous Systems Modeling Program - See CSMP. GC 

Control Card 6c 


A card or statement in a job which contains a command to the operating 
system or to a program. 


Control Character GC 
A character whose occurrence in a particular context initiates, 
nodifies, or stops a control operation; for example, a character to 
control spacing on a printer. 

Control Program GC 


A program which provides such functions as the handling of 1/0 
operations, error detection and recovery, program loading, and communi- 
cation between the program and the operator. 


Conversational, Interactive Gc 
Describes the interaction or dialogue which takes place (via a terminal 


device) between a user and a program running under a time-sharing 
system (such as MTS). 
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Conversational Mode, Interactive Mode GC 
A method of computer operation in which the user is in direct 
communication with the operating system and is able to control, 
interrogate, modify, and: observe the processing of his task. 
Conversational Tersginal, Interactive Terminal GC 


Normally a typewriter~like or CRT display device from which a user can 
communicate with a time-sharing system (such as MfS) on a real-time 


basis. 
Convertor - See Data Convertor. 6C 
CPI (Characters. per inch) - See Magnetic Tape Density. Gc 
CPU - See Central Processing Unit. GC 
CPU Bound 6C 


Describes a job which has a high computation content in relation to 
both the number of service requests (for example, I/O requests) and the 
total real time it spends on the computer. See also I/O Bound. 


CPU Time GC 
The time taken by the central processing unit to perform the operations 
requested. . 

Crosse-reference Listing GC 


An alphabetic list of all syabols used in a program and an ordered list 
of the numbers of all statements which reference a given symbol. The 
symbols can be statement labels, variable names, and so on. 
CRT - See Cathode Ray Tube. GC 
CSMP 6c 


Continuous Systems Modeling Program; a program package which allows the 
simulation of continuows processes. 


cycle Tine GC 
The length of tise a computer takes to perform its most primitive 


operation. The cycle time is a measure of the basic speed of a 
computer. 
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Data Line MTS 
Any line, not beginning with a "$", entered when the system is in MTS 
command mode, which cannot be interpreted as a command, and which has a 
line number associated with it. Data lines are written to the 
currently active file or device, if there is one. 

Data Record : | GC. 


A yrecord, for example a punched card, containing data to be processed 
by a program. See also Record. 


Data Set GC 

(1) A collection of data in one of several arrangements and described 
by control information to which the system has access; for 
example, in MTS, a file is a data set. 

(2) A device which performs the modulation/demodulation and control 
functions necessary to provide communication between computers and 
related devices via telephone lines. 

Debug Gc 


To detect, locate, and remove mistakes from a program, or malfunctions 
fron equipment. 


Debug Mode MTS 
The state in which the Symbolic Debugging System (SDS) is in control 
and monitoring a program which is being debugged. See also Symbolic 
Debugging Systen. 

Deck = See Card Deck. GC 

Default Definition, Default Option GC 


An assumption which is made about the value of a variable or parameter 
if no explicit choice is given by the user. 


Default I/O Unit Assignments MTS 
Assumptions which are made about the assignment of I/O units if no 
explicit assignments are given; for example, SCARDS defaults to 
*SOURCE* if it is not explicitly assigned to another file or device. 

Default Option - See Default Definition. GC 

Delimiter, Separator GC 
A special indicator that separates and organizes items of data; for 
example, the quote marks (*") enclosing literal character data in 


FORTRAN, the blanks that separate the elements of an MTS command, a 
SENDFILE card at the end of a data deck. 
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Delivery Code wso 


The first character within single quotes on the sigpon card on a batch 
job indicating where the printed and punched output should be manually 
delivered by the campus delivery systen. ‘ 


Density, Record Density 6c 


The number of bits in a single linear track measured per unit of length 
of the recording medium. See also Magnetic Tape Density. 


Device, Unit 6c 


Input-output peripheral equipment; for example, a card reader, magnetic 
tape drive, terminal, etc, — 


Device Command MTS 


A command, given in conversational mode, intended for the device 
support routine of the terminal at which it is given. These usually 
invoke (or revoke) special editing capabilities available at the 
terminal and should not be confused with MTS commands. The device 
support routines interpret device commands and never pass them on to 
MTS.. See also Device Support Routine. . 


Device Nase MTS 


A unique four character name assigned to each device. The device name 
is used to refer directly to a particular device. - For example, the 
device name assigned to a particular magnetic tape drive is TOC2. 
Device names do not normally concern the average programmer, since he 
is more likely interested in classes of devices, rather than individual 
devices. Thus, he sost often uses pseudo-device names, instead of 
device names. See also Device, Pseudo-device Name. 


Device Support Routine, DSR MTS 


A subroutine (or set of subroutines) which interfaces a particular 
device to the MTS operating system. The DSR handles all actual 1/0 
with the device, perforsing error recovery if necessary, recognizing 
attention interrupts, etc. Conversational terminal device support 
routines also provide several editing and typographical conveniences 
which are enabled or disabled via device commands. See also Device, 
Device Command. 


Diagnostic = See Error Message. ‘ GC 
Digital Computer 7 6c 


A machine capable of performing arithmetic and logical operations on 
data represented in numeric or character fora. 
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Digital Incremental Plctter GC 


A device that employs digital signals from a central processing unit to 
activate a plotting pen and a drum which carries the plotting paper. 
The plotting action results from step motions, that is, incremental 
motions, of the pen and/or drum. See also Calcomp Plotter, Plotter. 


Direct Access, Random Access GC 


Pertaining to the process of obtaining data from, or placing data into, 
main storage, where the time required for such access is relatively 
independent of the location of the data most recently referenced. For 
example, MTS line files allow direct access input and output. 


Direct Access Device Gc 


A device in which the access tine is effectively independent of the 
location of the data being accessed, for example, disks are direct 
access devices, 


Direct Access File Gc 


A file in which a given record may be accessed directly, without regard 
to other records in the file or to the relative location of the record 
in the file. MTS line files are direct access files. 


Disc ~ See Disk. GC 


Disk, Magnetic Disk GC 

A storage device consisting of a nusber of rotating flat circular 
plates, each coated on both surfaces with some magnetizable material. 
A number of concentric circular tracks are available on each surface. 
Data is read from or written to these tracks by means of read/write 
heads that can move radially to access a track. There may be _ several 
heads to each surface, a particular head being allocated a specific 
area (or sector) on the disk. In MTS, disks are used for line and 
sequential file storage, HASP batch queue storage, and paging. 


Dismounting - See Magnetic Tape Dismounting. GC 

Displacement 360 
All machine instructions which designate a main storage location 
contain a 12=bit number, called the displacement, which provides for 
relative addressing of up to 4095 bytes beyond the base address. The 


base address and displacement are added together to produce the actual 
address referenced. 
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Display Unit GC 


A device that provides a visual display of data on a CRT screen. IBM 
2260 terminals and Westinghouse 1600 terminals are examples of such 
devices. , 


Double Precision 6c 


A number representation in which two consecutive conputer words are 
used to hold a single numerical value. On some computers this 
effectively doubles the precision of numerical cajculations. With the 
IBM 360 series, double precision calculations involve approximately 16 
decimal digits of precision. See also Single Precision. 


Doubleword : 360 


A sequence of two fuallwords (8 bytes) capable of being treated as a 
unit. Such a sequence must have an address that is divisible by 8. 
Double precision floating point values are stored in doublewords. 


Drive - See Magnetic Tape Drive. GC 
Drum, Magnetic Drun GC 


Kk right circular cylinder with a magnetic surface on which data can be 
stored by selective magnetization of circular tracks on the curved 
surface. Data access is by means of stationary read/write heads 
positioned over each track of the rotating magnetic surface. In <MMTS, 
drums are used for paging and are not directly accessible to users of 
the systen. 


DSR ~ See Device Support Routine. MTS 

* DUMMY * MTS 
A special system pseudo-device which is always empty. On output, it 
represents an infinite waste basket; lines are accepted and disappear. 
On input, *DUMMY* acts like an empty file; every time a line is 
requested, an end-of-file condition is given. 

Dummy Parameter, Dummy Variable GC 
A parameter used in the definition of a sub-program. These are 
effectively replaced by the actual parameters provided in a call to the 
sub- program. ; 

Duamy Routine "ae GC 
A sub-program that (temporarily) replaces a routine that is missing, 
either because it is ao longer necessary, or because it has yet to be 


written. Dumay routines are often provided during the debugging stage 
of program developnaent. 
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Dummy Variable - See Dummy Parameter. 6c 
Duap GC 


To copy all or part of a storage device (main storage, magnetic tape) 
to another device (a printer) for subsequent examination. The term is 
also used to refer to the process by which the copy is made, and the 
actual results (printed output) of the copy. 


Duplex Systen GC 


A system in which two distinct central processing units operate in 
tandem to handle the work load. That is, both CPU's have access to the 
same facilities and job queues. A program may be executed by either or 
both CPU's. The WSU IBM System/360 Model 67 is a duplex systen. 


EBCDIC = See Extended Binary Coded Decimal Interchange Code. 
Edit 6c 


To modify the form or content of data; for example, to insert or delete 
characters such as page numbers or decimal points. 


Edit Mode MTS 


The state in which the context editor is in control for the purpose of 
making changes to a file. 


Editor GC 
A program which performs editing functions. 
Flapsed Time 6C 


The total apparent real time taken by a calculation, as measured by the 
time between the apparent beginning and the apparent end of the 
calculation. This is normally longer than the CPU time devoted to the 
calculation since active processing does not necessarily go on at all 
times. 


End-of-file, FOF GC . 


The indication of the end of a data set. Various end-of-file 
indicators (depending upon the device on which the data resides) are 
used to mark this point. There are hardware end-of-file indicators 
which always mark the physical end of data; for example, a magnetic 
tape file mark, or the last card read after the “endfile" button is 
pushed on a card reader. In addition, there are software end-of-file 
indicators which usually mark a logical, rather than physical, end of 
data; for example, in MTS, the characters SENDFILE in columns 1 to 8 of 
a card. See also Magnetic Tape File Mark. 
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End-of-file Mark - See Maqnetic Tape File Mark. GC 
End=-of-reel Marker - See End=-cf-tape Marker. GC 
End-of-tape Marker, End~of-reel Marker GC 


A strip of reflective material which signals the end of the usable 
portion of a nagnetic tape. This strip can be automatically detected 
by a tape drive. , 


Entry Point 6c 
In a progras, any point to which control can be passed from an external 
program. 

EOF = See End-of-file. '  6C 

Error Message, Diagnostic 6c 
An indication, anally a printed message, that an error has. been 
detected. 

Executable Statement 6C 


A statement in a programming language which, when processed (or 
compiled), causes executable object code to be generated. 


Execute Gc 
To carry out an instruction or perform (run) a routine. 
Execution Time, Object Time, Run Time . Gc 


(1) The length of time it takes to execute a progran. 
(2) The time at which a program is being executed, 


Explicit Concatenation | . MTS 


A form of concatenation in which files or devices are chained together 
to appear like a single file or device, for example, the explicit 
assignment of a single logical I/0 unit to chained files or devices. 
The files or devices are chained by giving the appropriate file, 
device, or pseudo-device names (with line number ranges or nodifiers, 
if desired). separated by "+" signs. Por exarmple, 5=FILEA (1,23) +* 
SOURCE* rages ies logical 1/0 unit 5 to an explicit concatenation of the 
lines of PILEA with numbers between 1 and 23, and the *SOURCE* 
pseudo-device. See also Concatenation, Implicit Concatenation. 


Extended Binary Coded Decimal Interchange Code, EBCDIC 360 
The character code used by IBA 360 computers to. represent characters. 


Bach character is uniquely represented by an 8=bit number, thus giving 
256 possible characters of which approximately 125 have been assigned 
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commonly used graphic and control functions. In addition to the 
numeric code, there is also an EBCDIC card punch code, which represents 
each character as a pattern of punched holes on a computer card. 
Extent - See File Extent. MTS 
External Symbol Resolution GC 


The process of linking together, during the loading process, all 
references of one (sub) program to any others. 


FDname MTS 
An abbreviation for file or device name. 
Fetch Protection GC 


A feature which prevents the accessing of data from specified areas of 
main storage. See also Memory Protect. 


Field GC 


In a record, a specified area used for a particular category of data; 
for example; a group of card columns used to represent a wage rate. 


File GC 


In general, a collection of related information, usually organized into 
smaller units called records. With MIS, the term is usually used to 
refer to files residing on direct access devices, although it is often 
used in reference to data on tapes. See also Line File, Private File, 
Public File, Sequential File, Sequential File With Line Numbers, 
Temporary File. 


File Extent, Extent MTS 


A block of contiguous disk tracks allocated to an MTS line or 
sequential file. - 


Filemark = See Magnetic Tape File Mark. GC 

File Protection GC 
The prevention of accidental overwriting of data files. File protec- 
tion can be by hardware (file protect rings on magnetic tapes) or 
software (by causing a program to check file names). 

File Protect Ring, Ring, Tape Ring, Write Permit Ring 6C 
A ring of plastic material which must be inserted into the slot 
provided on the back of a magnetic tape reel in order to allow writing 


of data on the tape. The presence or absence of a ting is detected by 
the tape drive hardware. (No ring, no write.) 
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Fixed Point GC 


Pertaining to a numeration system in which the position of the decimal 
point is fixed with respect to one end of the numerals, according to 
some convention. Por example, FORTRAN INTEGER constants and variables 
are fixed-point numbers with the decimal point assumed to be at _ the 
extrerme right of all of the digits. : 


Flag Gc 


Anything (for exaaple, a variable in a prograr) that is used to signal 
the occurrence of some condition. 


Floating Point GC 
Pertaining to a numeration syster in which the position of the deciaal 
point does not reaain fixed with respect to one end of the nuserals. 
This notation usually provides for some representation of a power of 
the base, to act as a scale factor. For example, FORTRAN REAL 
constants and variables are floating-point nuabers. 

Flowchart Gc 
A graphical representation of the definition, analysis, or solution of 
a problem, in which symbols are used to represent operations, data 
flow, decisions, equipgrent, etc. 

Format | 6c 
A specific arrangement of data. 

FORTRAN . Gc 
An acronym for Foygmula Translator. FORTRAN is a problea oriented high 
level programming language generally suited for scientific and mathe- 
matical use. 

FORTRAN=callable . . 6c 


Used in reference to a routine which is capable of being invoked 
directly by a FORTRAN prograr. 


PORTRAN G Compiler GC 
The IBM Level G FORTRAN IV compiler. It is used to compile FORTRAN IV 
source programs and to perfora other auxiliary services. See also 
FORTRAN H Compiler, WATFOR. 

FORTRAN H Compiler BC 
The IBM Level H FORTRAN IV compiler. It serves the same purpose as the 


FORTRAK G compiler (namely, the compilation of FORTRAN IV prograas) but 
is slower and sore expensive to run. However, it produces object decks 
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which generally take up less computer storage and execute more quickly. 
FORTRAN H should only be used for completely debugged programs. See 
also FORTRAN G Compiler, WATFOR. 

Fullword 360 
A sequence of 4 bytes (32 bits) that can be treated as a unit in 
numeric and character machine operations. The address of the 4-byte 
sequence must be divisible by 4. 

Global Time Limit aTS 
The maximum CPU time allowed an MTS batch job from signon to signoff. 
The global time limit is given, either directly or by default, with the 
SIGNON command. See also Local Time Limit. 

GPSS . 360 


General Purpose Simulation System; a program package which allows the 
simulation of discrete systems. 


Graphics - See Computer Graphics. GC 

GUSER MTS 
An acronym for "get from user." GUSER is a logical I/0 unit and 
defaults to *MSOURCE*. A user's responses to system and program 
queries are normally read from GUSER. 

Halfword 360 
A contiguous sequence of two bytes (16 bits) which comprises half of a 
fullword and is capable of being addressed as a unit. A halfword must 
have an address divisible by 2. 

Halfword Integer — 360 


A number between -32768 and 32767 inclusive which may be stored within 
a halfword. In FORTRAN, a halfword integer is designated as INTEGER*2. 


Hardware 6C 


Physical equipment, as opposed to a program (software) or a method of 
use; for example, card readers, line printers, card punches, magnetic 
tape drives, central processing units, input/output channels, etc. 


HASP, HASP Batch Monitor, HASP Monitor 360 


Houston Automatic Spooling and Priority System; a program which allows 
the queueing of batch input or output and a priority scheme for 
execution of batch jobs. See also Batch Processing, HASP Batch Mode, 
HASP Priorities. 
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HASP Batch Mode. a 360 
Jobs subuitted via HASP are sometimes said to run under HASP. batch 
anode. See also HASP, HASP Priorities, Conversational Mode, Remote 
Batch Mode, 

HASP Batch Monitor - See HASP. 369 

HASP Priority 360 
A parameter assigned to a HASP batch job, either by HASP itself or by 
the user, which determines, in part, the order in which the job is 
processed. 

Hexadecimal, Hex . GC 
(1) Pertaining to the nuaber system with a base of 16. 

(2) Pertaining to a characteristic or property involving a selection, 
choice, or condition in which there are 16 possibilities. 

High-level . 6C 
A term describing programaing languages that require extensive transla- 


tion before they can be understood by computers. PL/I, FORTRAN, ALGOL 
are examples of such languages. 


Hollerith Gc 
A term often used as a synonym for "character". See also Hollerith 
Code. 
Hollerith Code GC 
Reger card character code invented by Dr. ‘ Herman Hollerith in 
Hopper = See Card Hopper. 6c. 
ID - See ecid. MTS 
Image ~ See Card Irage. GC 
Immediate Value 6c 
A symbol which is considered to be a value, rather than a reference to 
a walue. 
Implicit Concatenation | MTS 


A method. of linking input files. or devices tagether, so that they 
appear to be a single file or device, through the use of a “SCONTINUE 
WITH" line within each of the files or devices to he linked (except the 
last). See also Concatenation, Explicit Concatenation. 
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Indexed GC 
Describes a method of data organization in which any record can be 
accessed directly by means of an index of record numbers. MTS line 
files are indexed according to MTS line numbers. 

Initial Program Load, IPL GC 
The initialization procedure that loads the operating system into the 
computer. The procedure must be carried out when the computer is 
started up, and when software or hardware problems necessitate a systena 
restart. 

Input 6C 


Information or data transferred or to be transferred from an auxiliary 
storage medium into the internal main storage of a computer. 


Input Device GC 
A device from which data can be read into the computer. 

Input Pile ; GC 
A file from which data is read. 

Input/Output, 1/0 6c 


A term used to describe anything (such as, equipment, data, programs, 
and so on) involved in communication with a computer. 


Input/Output Device GC 


Any part of the computing system hardware which is primarily used for 
the transmission of informaticn from one type of storage to another. 


Input Record GC 


A record read into or to be read into main storage from an auxiliary 
storage mediun. 


Instruction 6c 


That part of a computer program which tells the computer what function 
to perform. An instruction consists of the contents of a storage 
location or series of storage locations subdivided into groups which 
represent coded commands to the computer. An operation code, such as 
the codes for add or subtract, may be specified, along with one or sore 
addresses which specify the locations of operands to which the command 
is to apply. 
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Integer Variable 6C 
A variable which can take only integer values. 
Interactive - See Conversational. GC 
Interactive Computer Graphics GC 


A fora of computer processing in which a user can direct, in real tine, 
the course of action of a program by interacting with a visual display 
produced by the program. See also Computer Graphics. 


Interactive Terminal - See Conversational Terminal. GC 
Interblock Gap = See Record Gap. Gc 
Internal Representation i 6c 


This term refers to the manner in which numbers, characters, and 
instructions are stored within the computer's main storage. In asost 
digital computers, the method of representation is based on the binary 
number system in which all elements are combinations of the binary 
digits, 0 and1. The binary system is most widely used because of the 
convenience of constructing logic circuits and storage devices capable 
of handling data in this form. 


Internal Statement Number, ISN 360 
Numbers generated by compilers such as FORTRAN G and FORTRAN H and 
usually listed to the left of each statement. These numbers are 
generated so that every statement has a unique number which can be used 
in error comments and cross-reference listings to refer to the 
statement. These numbers should not be confused with ATS line numbers. 

Interpret Gc 
(1) To print on a punched card the readable symbols corresponding to 

the punches. : 
(2) To analyze and inmediately execute a source language progran. 

Interpreter - 6¢ 
(1) A machine used to interpret punched cards. 

(2) A program which executes source code as it encounters it, rather 
than after it has translated all the source code. 

Inter-record Gap - See Record Gap. GC 

Interrupt, Trap _ . j . 6c 
An interrupt is essentially a subroutine call to a specific location in 


main storage invoked automatically by the hardware rather than by a 
progran. It is used to informa the operating system of the occurrence 
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of some internal or external event that requires some action on the 
part of the operating system. For example, a card reader which has 
finished reading a card interrupts the CPU. to inform it that the I/0 
operation is complete; a program that attempts to divide by zero 
interrupts the CPU so that diagnostic action can be taken, and so on. 
The operating system deals with interrupts according to a complex 
algorithm that depends upon the type of interrupt, the current state of 
tne system, and so on. 


Interrupt Code GC 
A numeric code which serves to identify the type of an interrupt. In 
IBM 360 machines (except Model 67's in extended PSW mode), the 
interrupt code becomes part of the program status word when an 
interrupt occurs. 

Interrupt Mask 6C 


A program controllable binary switch which, according to its value, 
prevents or allows an interrupt. There is one switch for each type of 


interrupt. 
I/O = See Input/Output, GC 
I/O Bound GC 


Describes a job which issues a large number of input/output requests in 
relation to both the time required for coaputation and the total real 
time spent on the computer. See also CPU Bound. 

I/O Modifier MTS 
A character or set of characters beginning with an "@" appended to a 
file or device name in order to change the way in which it is treated 
or regarded during I/0 processing. 

IPL = See Initial Prograrg Load. GC 

Irrecoverable I/0 Error 6c 


A persistent error condition on an input/output device such as a 
magnetic tape drive, disk, etc. 


ISN = See Internal Statement Number. 360 
JCL = See Job Control Language. 360 
Job Gc 


A group of tasks prescribed as a unit of work for a computer. By 
extension, a job usually includes all necessary programs, data, and 
instructions to the operating system. In MTS, a job is delimited by 
the SIGNON-SIGNOFYF commands. 
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Job Control Language, JCL . 360 


The language that. allows the user to interact with the IBM Operating 
System/360 (08/360) in order to use the computer. 


Job Deck : ; 6c 


A collection of punched cards comprising a complete batch job. On MTS 
at WSU, a job deck begins with an S-8 card, and’ is followed by a 
$SIGNON cosgmand, and some combination of commands, programs, and data, 
and terminates (optionally) with a S$SIGNOFF command. 


Justify Gc 


To align data about a specified reference. Frequently, the term is 
used in reference to data preparation. To "right justify" data is to 
move the data as far to the right in the allotted space (field) as 
possible. An analogous definition holds for "left justify". 


K GC 


In computer terminology, the symbol "K" usually represents two to the 
tenth power, that is, 1K=2!°=1024. For some decimal computers, for 
example, the IBM 1401 and 1410, "K" represents ten to the third power, 
or 1K=103=1000. 


Key : ; 6c 


One or more characters or numbers within an item of data which serves 
to identify or control the data or its use. For example in sorting, 
the “sorting key" is that number or string of characters in each data 
record according to which the data is sorted. . 


Key punch : 6c 


A keyboard operated sachine used to punch holes into computer cards. 
The operator simply depresses keys on a typewriter-like keyboard to 
cause holes to be punched column by column into the card. 


Keyword Parameter GC 


A parameter in a command or programming statement which is of the form 
"KEYWORDzoperand", for example, T=60 on the SSIGNON command, and 
MAP=*SINK® on the $RUN command. The operand is variable, the keyword 
name is fixed. In some cases, there is no operand and the fora is 
"KEYWORD"; this is sometimes referred to as a degenerate keyword. 


Label 6c 
One or sore characters used to identify an item of data. The term is 


most often encountered in reference to a string of characters which 
serves to identify a statement in a program, It is also used in 
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reference to identifying information found on magnetic tape. See also 
Magnetic Tape Label. ; 


Left Justify - See Justify. GC 
Library File | MTS 


A file which contains sub-programs in the form of an MTS sub-progran 
library. This term also has been loosely used as a synonym for "public 
file." 


Library Programs 6c 


A collection of programs and/or subprograms available to every user of 
the computing system. With MTS at WSU, library programs are usually 
available in public files and public library files. However, the term 
is usually used in reference to any program supplied and supported by 
the Computing and Data Processing Center, regardless of the form of 
availability. 


Light Pen 6c 


A photoselectric device, about the size and shape of an ordinary pen, 
used as an adjunct to a CRT display unit. The user can pass the pen 
over the surface of the CRT to select images displayed on the screen. 
The light pen selection of an image can be used to initiate some 
programming action; for example, modification of the image being 


displayed. 
Line = See Record. GC 
Line File MTS 


A direct access file consisting of ordered lines which may be up to 255 
characters long and are each identified by a unique line number. See 
also Line Number. 


; 
Line Number MTS 


A number which uniquely identifies each line in a line file. External- 
ly, line numbers are in the range -99999.999 to #99999 .999. Internale- 
ly, MTS stores the line numbers as fullword integers. See also Line 
File. 


Line Number Range MTS 


A qualification put on a file, device, or pseudo-device name to 
indicate that only certain records from the file or device are of 
interest. The forma of the qualification is "FDname(b,e,i)", where "b* 
is the number of the beginning record (line) of interest, "“e" is the 
ending record, and "i" is the increment to determine the numbers of 
intermediate records between "b” and "e". 
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Line Printer = See Printer. 6c 
Linkage Editor _ | 360 


A prograam that takes object prograas as produced by any of the language 
processors and transforms therm into a form that loads very efficiently. 


Listing Gc 
A printed copy of a progran, a set of data, etc. 
Literal 6C 


A symbol or a quantity in ‘a source program that contains its value as 
an explicit part of its ‘nape. 


Load 6c 
Usually, to read an object prograrg into the computer's main storage, 
and prepare it for subsequent execution by carrying out the necessary 
relocation and resolution of external references. See also Load Map, 
Load Time, Loader, Object Program, Relocation, External Syabol Resolu- 
tion, Unload. 

Load Map GC 


Listing of the memory locations at which prograas and sub-programs have 
been loaded. 


Load Module - See Object Prograns. 6C 

Load Point 6c 
That point which is the beginning of the usable portion of a sagnetic 
tape. It is the position of a tape after it has been rewound. See 
also Load Point Sarker. 

Load Point Marker Gc 


A strip of reflective saterial that sarks the load point of a sagnetic 
tape. It is automatically sensed by the tape drive hardware. 


Load Tine 6c 
(1) The CPU time required for an object program to be loaded into 
(2) the tine at which the load process is taking place. 

Loader | GC 


A progrea which reads object prograas into main storage and prepares 
thea for subsequent execution. See also Load. 
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Loading Routine - See Loader. 
Local Time Limit MTS 
A limit on the amount of CPU time that can be used by one segment of a 


-complete computer job. In MTS, local time limits can be specified for 
single RUN commands. See also Global Time Limit. 


Location = See Storage Location. 6c 
Logical Address - See Virtual Address. GC 
Logical Carriage Control GC 


Control of the vertical spacing of printed output as it is normally 
encountered at the prograasing level. Logical carriage control uses a 
set of carriage control characters whose action is related to a logical 
page which, in MS, consists of 60 lines centered on each individual 
sheet of paper. Each logical carriage control character must be 
translated into its equivalent machine carriage control character 
before being sent to the the printer. The translation is done within 
the operating system and need not concern the programmer. See also 
Carriage Control Character, Machine Carriage Control. 


Logical I/O Unit, Logical Onit, Logical Unit Number MTS 
A name or number which may be used in a program to refer to an I/0 
device. The name is not connected with any particular file or device, 
so the program is independent of the actual file or device which is 
eventually used. The MTS logical I/O units are SCARDS, SPRINT, SPUNCH, 
SERCOM, GUSER, and 0 through 19. 

Logical Record GC 


A logical unit of data. See also Blocking. 


Logical Unit = See Logical I/O Unit. MTS 
Logical Unit Number = See Logical I/0 Unit. MTS 
Low-level GC 


A term usually used when describing computer languages. Low-level 
languages are those close to machine language in syntax. 


Low-order Position GC 
The rightmost position in a number or word. 

Machine Carriage Control GC 
Control of the vertical spacing of printed ouput. Machine carriage 


control differs from logical carriage control in that it uses a set of 
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carriage control characters whose action is related to the actual 
hardware that causes the paper movement, rather than to a logical page. 
See also Carriage Control Character, Logical Carriage Control. 

Machine Language . GC 


Refers to instructions written in the code which can be immediately 
executed by a computer without any translation. 


Machine Word = See Fullword. GC 
Macro, Macro Instruction Gc 
A source language instruction that is replaced, during translation, by 
a predetermined sequence of machine instructions, usually with provi- 
sions for parameter replacenent. 


Macro Library GC 


A library which contains routines that are written in a macro language. 
With 360 computers, these are written in the 360-assembler macro 


language. 
Magnetic Disk - See Disk. GC 
Magnetic Drum - See Drun. . . GC 
Magnetic Tape, Tape 6c 


A storage medium composed of a continuous strip of plastic material 
which is coated with a magnetic oxide. Data is recorded on this 
surface aS a series of magnetized spots. For 360 use, the tape is 
recorded in either 7 or 9 parallel tracks along the length of the tape, 
and is wound around a plastic reel which normally holds 225, 600, 1200, 
or 2400 feet of tape. At WSU, all tapes aust be 9 track; tapes 
assigned to users by the tape librarian are generally 2400 feet long. | 
Tapes are useful for the storage of large volumes of fairly static 
data, and for shipping them by mail. 


Magnetic Tape Density, BPI, or CPI, Tape Density 6c 
The number of bits per track or characters per inch of magnetic tape. 

Magnetic Tape Dismounting, Disaounting, Tape Dismounting GC 
Removing a reel of magnetic tape from a tape drive. 

Magnetic Tape Drive, Drive, Tape Drive, Tape Unit GC 
A device consisting basically of a mechanism capable of moving two tape 
reels at a high speed so that tape is wound from one reel onto the 


other. As the tape is transported between the two reels, it passes a 
read/write head which is used either to read from or write to the tape. 
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Magnetic Tape File Mark, End-of-file Mark, File Mark, Tape Mark Gc 
The end-of-file indicator on magnetic tape. For 360 use, it consists 
of a hardware-generated "tape mark gap" (a length of blank tape), and a 
special hardware-generated record which the hardware recognizes when 
reading the tape. 

Magnetic Tape Label, Label, Tape Label 6c 
One or more blocks of information recorded at the beginning of a reel 
of magnetic tape. The first block contains identifying information 
that is. used to check that the correct tape has been mounted by the 
computer operator. Subseguent blocks may contain dating or other 
information with reference to the actual identifying information in the 
first label block. . 

Magnetic Tape Mode, Mode, Tape Mode Gc 


Describes the physical properties of magnetic tape data; such as, 
density, parity, convertor on or off, and so on. 


Magnetic Tape Mounting, Mounting, Tape Loading, Tape Mounting GC 


The process of placing a reel of magnetic tape onto a tape drive, and 
preparing it for reading or writing. 


‘Magnetic Tape Reel, Reel, Tape Reel 6C 
A plastic spool around which magnetic tape is wound. 
Magnetic Tape Rewind, Rewind, Tape Rewind 6C 


To position a tape at the load point marker after reading from or 
writing to the tape. See Load Point Marker. 


Magnetic Tape Ring = See File Protect Ring. GC 
Magnetic Tape Unit = See Magnetic Tape Drive. GC 
Main~line Program, Self-contained Progran 6c 


A program that can be executed directly rather than having to be called 
from another routine. 


Main Storage, Main Memory 6c 


The general purpose storage of a computer. Usually, main storage can 
be accessed directly by the operating registers in the central 
processor as contrasted to auxiliary storage which cannot. In general, 
all program-addressable storage from which instructions say be executed 
and from which data can be loaded directly into registers is called 
main storage. See also real memory, virtual memory. 
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Map - See Load Map, Memory Map. GC 
Mask 6c 


A pattern of bits or characters that is used to control the selection, 
retention, or elimination cf portions of another pattern of bits or 
characters. 


Memory Map 6c 


A listing of all variables, constants, and statement labels in a. 


program, and the storage lccation, usually relative to the start of the 
program, assigned to each. A memory map is typically produced by a 
compiler. See also Load Map. 


Memory Protect 6c 


A feature that prevents the writing of data into specified areas of 
main storage, thus preventing a program from destroying the operating 
system or another user's program. In IBM 360 cogputers, the protected 
area is designated by a key in the program status word. Once the key 
is set, the program can only write into sections of storage that have 
the same key. See also Memory Protection, Protect Key. 


Memory Protection, Storage Protection 6c 


An arrangement for preventing access to storage for either reading or 
writing or both. See also Memory Protect, Protect Key. 


Michigan Terminal System, MTS MTS 


An operating system designed to run on an IBM System 360 Model 67 
computer. It is a multi-programming, multi-processor, interactive, 
timeesharing system that offers compatible batch and terminal facili- 
ties, and makes use of the special hardware features of the Model 67 in 
providing these facilities. MTS was developed by the University of 
Michigan Computing Center staff. 


Mode = See Magnetic Tape Mode. Gc 
Modes of Operation MTS 


(1) The MTS operating system allows computer access in several ways, 
for example, conversational terminal access, HASP batch access, 
remote batch access. Each of these can be referred to as a "node 
of operation". See also Conversational Mode, HASP Batch Mode, 
Reszote Batch Mode. 

(2) The TS command language has several modes of command operation. 
they are MTS command mode, edit mode, debug mode, or network mode. 
See also MTS Command Mode, Edit Mode, Debug Mode, Network Mode. 


Modifier - See I/O Modifier. . MTS 
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Module 6c 


A program unit that is discrete and identifiable with respect to 
compiling (the source rgodule) and loading (the object module). 


Monitor GC 


Software or hardware that observes, supervises, controls, or verifies 
the operation of a systen. 


Mounting - See Magnetic Tape Mounting. GC 

*MSINK* MTS 
A pseudo-device used for output. MSINK stands for master sjnk, which 
is always the terminal in conversational mode or the printer in batch 
node. 


+MSOURCE* | MTS 


A pseudo-device used for input. MSOURCE stands for master source, 


which is always the terminal in conversational mode or the card reader 
in batch node. 


MTS = See Michigan Terminal Systen. MTS 

MTS Command MTS 
A command to the MTS operating system; an element of the MTS command 
language. 

MTS Command Mode | MTS 


The state during which MTS is ready to accept either commands or data 
lines for the currently active file or device. At a terminal, MTS 
command mode is usually indicated by the presence of the "#" prefix 
character. 


Multi-level Storage Systen GC 
A system in which the most frequently used information is kept on 
higher speed storage devices, while less frequently used data is stored 
on slower auxiliary storage devices. 


Multi-prograaning Systen GC 


A system that supports more than one programa in a state of activity at 
one time. MTS is one such systen, 
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Multi-processing System . GC 
An operating system which runs on a computer that has more than one 
central processing unit. STS is such a system. (The IBM 360 Model 67 
at WSU is a dual-processor, that is, a duplex machine.) 

Nesting Gc. 
Pertaining to a set of programming instructions that contains a 
structure similar to itself; for example, a loop of instructions that 
contains another loop, and so on, possibly down through several levels. 

Nine=track Magnetic Tape GC 
Magnetic tape that has been written on a 9=track drive. 

Nine-track Magnetic Tape Drive GC 


A magnetic tape drive that writes 9 bits accross the tape, 8 data bits 
plus a parity bit. 


Non-nurgeric Character GC 
A character that is not a numeral. 

Non=printing Graphics 6c 
Characters that can be represented within the computer, but for which 
there is no corresponding visible character on the printing device 
(such as, printer or Teletype). If one attempts to print such 
characters, a blank usually appears. 

Object Code ~ 6C 
Output from a prograsping language processor that is itself executable 
machine code or is suitable for processing to produce executable 
machine code. 

Object Deck GC 
A deck of cards which contain object code. 

Object File | | 6c 
A file containing object code. 


Object Language 6c 


The language in which the output fron a programming language processor 
is expressed. 
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Object Module - See Object Program. GC 
Object Program, Object Module GC 


A program or sub-program in object code form. 

Object Time - See Execution Tine. GC 

Octal 6C 
(1) Pertaining to the number system with a base of 8. 

(2) Pertaining to a characteristic or property involving a selection, 
choice, or condition in which there are 8 possibilities. 

Off-line 6c 
Descriptive of a system (and its peripheral equipment) in which the 
operation of the peripheral devices is not under the control of the 
central processing unit of the main computer. 

OMR, Optical Mark Reader GC 
A device capable of reading cards marked with pencil. 


Onedemand Systen GC 


A system from which information or service is available immediately at 
the time of request. 


On-line Gc 


(1) Describes peripheral devices under direct control of a CPU. 
(2) Pertaining to a user's ability to interact with a computer. 


Opening a File GC 


The process of collecting the information necessary to begin I/0 
operations on a file. 


Operating System GC 


Software which controls the execution of computer progrargs and which 
may provide scheduling, debugging, I/0 control, accounting, compila=- 
tion, storage assignment, data management, and related services. The 
Operating system at WSU is the Michigan Terminal System (MTS). See 
also Michigan Terminal System, OS, TSS. 


Operator's Console, Console 6C 
The operator's console contains all the switches and indicators 
necessary for the operation of the central processor. It allows for 


such things as turning power on and off, starting and stopping the 
system, error status display, main storage and register display, etc. 
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Most consoles incorporate an alphanuseric display device (such as a 
typewriter or CRT) for communication between the operating system and 
the computer operator. 


os 360 


The IBM operating system for IBM Systea/360 and 370 computers with more 
than 64K of main storage. 


Out put 6c 


The transferring of data from main storage to auxiliary devices. The 
term is also used to describe the devices and the data involved in such 
a transfer. 


Output Device Gc 


Peripheral equipment to which output can be directed; for example, a 
printer, magnetic tape drive, disk file, etc. 


Output Record GC 
A unit of data intended for an output device. 
Padding GC 


The act of appending fill characters (usually blanks) to a record to 
bring it up to a specific length, for example, padding with trailing 
blanks. 


Page 6C 


A unit of storage in a computer which is used by the addressing 
hardware to allow references to a location to be done as a displacement 
from a base address. For the IBM 360 Model 67, a page is 4096 bytes. 
See Paging. 


Paging GC 


Paging is a storage management technique which facilitates the roving 
of user programs in and out of high speed storage to slower peripheral 
storage. The various storage devices are divided into pages, and 
information is tranferred from main storage to auxiliary storage in 
page-sized blocks. Any subset of the pages assigned to a program can 
be in storage at one time. It is possible to allow a program to access 
more storage than is physically available in the systesa, for pages 
which are not currently required can reside on the auxiliary storage 
devices. With MTS, drums (and disks if the systema is busy) are used 
for paging. Each user is provided with 6 million bytes of storage, 
even though the system has a total of only two million bytes of main 
storage. See also Virtual Memory. : 
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Paper Tape GC 


A computer I/O medium which is a strip of paper into which information 
can be recorded by means of a pattern of punched holes. Each character 
is recorded as a single row of holes across the width of the tape. 


Paper Tape Punch GC 


A device for punching holes in paper tape in response to signals 
transmitted from a computer. 


Paper Tape Reader GC 


A device that senses and translates the holes in paper tape into 
electrical signals for input to a computer. 


Paper Tape Transmission Code 360 


A character transmission code for use between a terminal device and a 
computer. Each character is uniquely represented by a 6=bit number 
with a seventh bit generated for parity. The parity bit is used as a 
check bit. 


Parameter 6C 


A unit of variable information passed by a user to the operating systen 
or from one program to another. 


Parity Bit GC 


A check bit used to assure the validity of stored data (whether the 
data is in main storage or tape or wherever). In general, the parity 
bit is an extra bit attached to a small part of storage (with IBM 360 
computers, usually the byte). When data is stored, the parity bit is 
set so that the sum of all the bits set is either even or odd (usually 
odd). When the data is read back, the associated parity bit is checked 
to be sure that the odd or even relationship still holds - if not, the 
hardware signals an error condition. 


Password MTS 


A user controlled character string which aust be given (together with 
an ID code) with the SIGNON command in order to gain access to the 
computing system. The password is part of the security mechanisna 
preventing people from using ID's, and therefore accounts, that aren't 
their own. See also Password Card. 


Password Card NTS 
In batch mode, the password should always be given on the card follwing 
the SIGNON command. This password card is not printed with the rest of 


the job's output, and thus the security of the password is maintained. 
The password card should be punched with keypunch printing disabled. 
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PDN = See Pseudo-device Name. GC 
Peripheral Unit 6c 


A machine which can be operated under corgputer control. Peripheral 
equipment includes input devices (such as, card readers, or magnetic 
tapes), output devices (line printers, plotters), and storage devices 
(disks, drums). 

Permanent File MTS 
Any file that is created by a user and which does not have the scratch 
file character (usually a minus sign “-") as the first character of its 
name. Such files are automatically saved until they are explicitly 
destroyed with a DESTROY command. See also File, Line File, Sequential 
File, Public File, Library File. 

Permit Code MTS 
A code attached to a file which controls access to the file. 

Physical Record, Block GC 


A unit of information as it appears on some storage nediun. See also 
Logical Record, Record. 


PIL, PIL2 GC 


Pittsburgh [Interpretive Janguage; an interactive, procedure-oriented 
language designed for terminal use. 


PL/I GC 


Programming Language JI; a high-level programming language suitable for 
both scientific and business use. 


PL/I Library MTS 


A file *PLILIB containing the object decks of subroutines frequently 
referenced by PL/I prograags. 


Plotter GC 


An electro-mechanical device used to produce computer generated draw- 
ings, graphs, etc. 


Positional Parameter GC 
A parameter whose identity is determined by its particular position in 


a sequence of parameters; for example, in MTS, the ccid code must be 
the first parameter given with the SSIGNON command. 
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Precision - See Single Precision, Double Precision. Gc 
Prefix Character MTS 


The first character of each line on conversational terminals is called 
the prefix character. The sost important prefix characters are printed 
by MTS and are: "#" which is issued when the terminal is in sTS 
command mode, “>* which is issued with output from the LIST and COPY 
commands, and "?" which is issued to prompt for responses to queries. 
Output and input lines for user programs are also preceded by prefix 
characters, normally the blank. 


Preprocessor Gc 


A term used to refer to a program which transforms data in some way 
before it is used by another progran. 


Printer GC 
An output device which converts data into printed form on paper. 
Printer Plot 6c 

Graphical output produced on a printer. 
Priority GC 


A parameter determining, in part, the order in which batch jobs are 
processed. See also HASP Priority. 


Private File - See Permanent File. MTS 
Problem State GC 


When a computer is executing the instructions of a problem program (as 
opposed to the operating systea), it operates in what is called the 
problem state. In this state, all I/0 instructions and a subset of the 
control instructions are invalid. This ensures that one user's program 
cannot execute an instruction that affects other users! programs. See 
also Supervisor State. 


Procedure-oriented Language - 6c 
A higher-level language suitable for expressing algorithms quite 
directly. 
‘Processor = See Central Processing Unit. 6c 
Program 6c 


(1) A series of instructions in some computer language. 
(2) To design, write, and test such a series of instructions. 
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Program Interrupt 360 
A specific category of interrupts which is caused by the execution or 
attempted execution of an illegal instruction or an illegal use of data 
for an instruction. 

Program Segment GC 
Usually a set of programming instructions which have some sort of 
logical or physical connection, but which do not form a_ complete 
program as defined by the particulat programming language used. 

Program Status Word, PSW | 360 


A doubleword containing information necessary to describe the status of 
the conputer. 


Project MTS 
A designation of a group of MTS ccids with a common account to be 
billed. 

Protect Key GC 


A flag in the program status word on the System 360 which designates 
the parts of main storage into which a program aay write. A program 
can write into only those areas which have the same _ key. Thus, if 
different users are given different protect keys, then one user can in 
no way affect another user. See also Menory Protect, Memory 
Protection. 


Pseudo=device , MTS 
Logical device classes which are used in place of actual devices so 
that programmers need not concern therselves with the physical devices 
their prograas use. The correspondence between the logical device 
class and the physical device used is made by the operating systen. 
See also Pseudo-device Nane. 

Pseudo-device Nane MTS 
The name of a pseudo-device. Por exaraple, in MTS batch mode, the 
pseudo=device name referring to the printer is *MSINK*. In MTS, each 
pseudo-device name starts and ends with an asterisk (*). Soe names 
are predefined by the system, and others can be defined by the user. 

PSW = See Program Status Word. 360 


PTTC - See Paper Tape Transmission Code. 360 
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Public File pe MTS 


A file which has a name starting with an asterisk (*), CCAP:, HELP:, or 
DEMO:, which can be read by all users of the computing systen. 
Computing center staff use public files to maintain programs and 
subprograms of general interest. 


Public Library File MTS 
A public file containing object modules organized as an MTS sub=-program 
library. The term has been used (loosely) as synonyaous with "public 
file". In this context, "library" refers to those programs and 
sub=-programs provided by the Computing Center for generat use, rather 
than to the actual format of the file. 

*PUNCH* MTS 


A pseudo-device name referring to the system card punch. 


Punch = See Keypunch, Paper Tape Punch, Reproducing Punch. GC 
Punched Card - See Card. ; Gc 
Punched Output GC 


Computer output produced by some sort of punch device, such as, a card 
punch or a paper tape punch. 


Queue - See Batch Queue. GC 
Rack Number NTS 


A number assigned to the physical storage location of each magnetic 
tape in the Computing Center's storage racks. 


Random Access = See Direct Access. Gc 
Raw Data | GC 
Data which has not been transformed or otherwise processed. 
RC = See Return Code. GC 
Read . GC 
To acquire or interpret data from a storage device or any other source. 
Reader , \ | : GC 
A device which converts information in one form of ‘storage to 


information in another fora of storage. See also Card Reader, Paper 
Tape Reader. 
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Read-only Storage a . 6c 
Describes storage from which data can be read bet not changed. 
Readewrite Head 6c 


An electroragnetic device used to read data frop or write data onto a 
magnetic mediurm such as aagnetic tape, disk, or drum. 


Real Address : 6c 


An address that indicates, in the machine code address numbering 
system, the exact storage location where the referenced operand can be 
found or stored. 

Real Merory 6C 


A term referring strictly to the primary storage pedium (usually sain 
storage) of a computer. See also Virtual Hemory. 


Real Tine Gc 

(1) Pertaining to the actual time taken for a physical process. 

(2) Pertaining to the performance of a computation during the actual 
time that a related physical process is taking place, often in 
order to monitor and guide the process. 

Real Variable , : 6C 

A variable whose value is numeric and stored in floating point form. 

Receipt Card = See S-8 Card. _ MTS 
Record | GC 


A collection of related items of data, treated as a unit. See also 
Logical Record, Physical Record. 


Record Density - See Density. 

Record Format i | 6c 
The organization of a record. 

Record Gap, Inter-record Gap, Interblock Gap 6c 


A length of blank tape (9.6 inches long for 9-track tape, 0.75 inches 
for 7*track) used to separate physical records on magnetic tape. 


Record Index 6c 


A quantity that points to the next record to be processed. 
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Record Length GC 
The number of units (bytes with IBM 360 computer) of data in a record. 

Reel GC 
The plastic spool about which magnetic tape is wound. 

Re-entrant Gc 
Descriptive of a program that doesn't modify itself in any way. In a 
time-sharing computer system, a single copy of a re-entrant program can 
be used by many users “at the same time". Since such a program doesn't 
modify itself, one person's use of the program cannot affect another 
personts use. 

Register GC 
Part of the central processing unit of the computer which holds 
information to be subjected to arithmetic and logical operations. In 
IBM 360 computers there are two types of registers; general registers 
for logical and integer numeric operations, and floating-point regis=- 
ters for floating-point numeric operations. 

Relative Addressing . GC 
A system of programming in which instructions are written so that they 
refer to some base location (usually the start of the programa) rather 
than to an absolute storage address. When the program is executed, the 
base address is added to the address component of each instruction in 
order to create absolute addresses. 

Remote Batch Mode 6c 
Refers to the submission of non-interactive jobs to the computer fron 
card readers not located with the computer. See also HASP, HASP Batch 
Mode, HASP Priorities. 

Remote Terminal GC 
An I/0 device not located with the computer. The term usually refers 
to conversational terminals, but is used to describe batch (non- 
interactive card reader/printer) terminals also. 

Reproducing Punch Gc 


A machine which reads a deck of cards and automatically produces a 
duplicate copy. 


Resident System Gc 
A term used to denote that part of the operating system which resides 


in main storage at all times. 
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Resolve External Symbol Resolution. 6C 
Resolwe Library References ~ See External Syabol Resolutuion. GC 
Response Tine GC 


The real time taken to complete a requested compytation. The term is 
usually used in reference to calculations done at conversational 
terminals. 


Restart Gc 
To re-establish the execution of a progras. 
Return Code, RC 6C 
<A number returned by sub-prograns that indicates the success or failure 
of some part of the task done by the sub-prograa. In IBM 360 
computers, it is usually returned in general register 15 and is a 
multiple of 4 in walue. The return code is used by FORTRAN to set up 
multiple returns from subroutines (that is, RETURN 1, RETURN 2, etc.). 
Re-usable 6c 
The property or attribute of a program which makes it self initializing 


so that it can be used more than once, or by more than one user, but 
not necessarily at the same time, See also Re-entrant, Serially 


Re-usable. 
Rewind - See Magnetic Tape Rewind. 6c 
Right Justify - See Justify. _ 6C 
Ring - See Pile Protect Ring. | GC 
Round-off Error | 6C 


An error resulting from the procedure of deleting some of the less 
significant digits of numbers and, possibly, applying some rule of 
correction. 
Routine . 6c 
A program or sub-prograa. See also Program, Sub=-prograr. 
Run Time - See Execution Tine. 6c 
Save Area 360 
The storage area belonging to a calling program and used by the called 


program to save and later restore general registers and other 
information. 
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SCARDS MTS 


A logical I/0 unit which defaults to *SOURCE*. SCARDS stands for 
System cards. 


Scratch File = See Temporary File. MTS 
SDS = See Symbolic Debugging Systen. MTS 
Secondary Storage - See auxiliary storage. GC 
Self-contained Program = See Main-line Program, GC 
Sense Bytes 360 


Coded information, generated by hardware, concerning the status of a 
device. For example, sense bytes give information about the cause of 
tape reading errors. 


Separator = See Delimiter. 6c 

Sequential File GC 
(1) A data file in which the records must be accessed in a fixed 

order, one after the other. Magnetic tape files are sequential 
files. 
(2) A particular type of MTS file organized as in (1). 

SERCOM MTS 
A logical I/O unit which defaults to *MSINK*. System and program error 
messages are normally directed to SERCOM. SERCOM stands for systen 
error comments. 

Serially Re-usable Gc 
Describes a program that can be ased again and again from the beginning 
without having to be reloaded into main storage, but which only one 
user can use at a time. See also Re-entrant, Re-usable. 

Seven-track Magnetic Tape 6c 


Tape that has been written by a 7-track magnetic tape drive. See also 
Seven=track Magnetic Tape Drive. 


Seven-track Magnetic Tape Drive - GC 
A magnetic tape drive that records data in 7 channels running 


lengthwise along the tape. Six bits across the tape are used to hold 
data and one bit is for parity. 


Glossary of Computing Terms 485 


MTS Volume 1; HTS -- The Systen 


April 1974 


Severity Code 6c 


An indicator associated with an error message produced by a language 
processor and which indicates the seriousness of the error. 


Signon id =~ See Ccid. ; MTS 
Single Precision 6c 


The use of a single computer word to hold the resylts of calculations. 
See also Double Precision. 


*SINK* MTS 
A pseudo-device nase referring to an output file or device. It 
defaults to the terminal in conversational aode and the printer in 
batch anode. However, its designation may be changed with the SINK 
command. 

Snark . MTS 


A condition of multiple program interrupts in MTS which requires the 
systema operator to take special action to sign off the affected user. 


SNOBOL GC 


A symbol manipulation language which is useful for language transla- 
tion, program compilation, and combinatorial problens. 


Software GC 
Programs, as opposed to hardware. See also Hardware. 
Sorter 6c 


A machine used for sorting punched cards into some desired sequence 
according to information punched on the cards. 


*SOURCE* MTS 
A pseudosedevice name referring to the input file or device from which 
MTS commands and data for the currently active file are taken. It 
defaults to the terminal in conversational aode and to the card reader 
in batch mode. However, the *SOURCE* file or device can be changed 
with the SOURCE command. 

Source Deck GC 


A card deck on which a program has been punched in a computer language 
other than machine code. 
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Source Language, Symbolic Language GC 
Any prograaming language which cannot be directly processed by a 
computer, but requires translation into an object program consisting of 
machine code instructions, for example, PL/I, FORTRAN, ALGOL. 

Source Program | 6c 
A program as written in a source language. 

Special Character GC 
A character that is neither alphabetic, numeric, nor a blank. 

SPOOLING 6c 
(Simultaneous Peripheral Operations Qn-line) A process whereby the 
system reads all cards for a batch job before starting the job, and 
saves the printed output until the job is finished before starting to 
print it. This is in distinction to having the card reader and printer 
attached to the job for the duration, thereby forcing all jobs to 
proceed at the rate of the slowest component. 

SPRINT MTS 


A logical I/O unit which defaults to the pseudoedevice *SOURCE*. 
SPRINT stands for system print unit. 


SPUNCH MTS 


A logical I/O unit which defaults to the pseudo-device *PUNCH*. It is 
the system punch unit. 


Stacker - See Card Stacker. 6c 
Station 6c 


The location of a computer input/output device, as in, for example, a 
remote batch station. 


Storage 6c 
Any medium for storing information so that it is available to a 
computing system when required. See also a,ain storage, auxiliary 
storage, Virtual Memory. 

Storage Location : GC 


A particular position within the main storage of a computer. 


Storage Protection - See Memory Protection. GC 
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Store 6c 
To enter or retain data.in a storage device. 
String Gc 


A sequence of information elements of a Similar type (such as bits, 
bytes, characters), treated as a single item of data. 


Sub-program, Subroutine GC 
A part of a larger program written in such a way that allows it to be 


called from several: places in the, main prograa.. Ai sub-program may. be 
translated into machine language and tested independently of the main 


prograag. 
Subroutine — See Sub-progran.. GC 
Supervisor, Supervisor. Progras GC 


A program (or system of programs) that is always available in the 
computer's main storage for controlling the sequencing, setup, and 
execution of all jobs entering the coaputer. A supervisor is usually 
one part of an operating system. UMNMPS is the supervisor for MTS. 


Supervisor Call 360 


A special instruction used by a program to force an interruption of the 
job in progress through a transfer of control. tothe supervisor. This 
action is needed for input/output operations and other operations that 
place special demands on the resources of the computer system. A 
supervisor call. causes a transfer fror the problem state to the 
supervisor. state. See also Problem State,. Supervisor, Supervisor 
Interrupt, Supervisor State. 


Supervisor Interrupt : 360 


A transfer of control. to the supervisor. because of some. exceptional 
condition... This may arise in the prograa being executed (for example, 
through division by zero), or in sone other process that is being 
handled concurrentiy (for example, input/output). See also Problen 
State, Supervisor, Supervisor State, Supervisor Call. 


Supervisor Program =: See Supervisor. 6C 
Supervisor State 6c 
A special condition of the central processor that permits execution of 
all instructions in’ the repertoire of the machine, including control 


and input/output instructions not directly available to the user. See 
also Problem State. 
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Supervisor Task Number, Task Number MTS 
The number which the supervisor (operating system) assigns to each task 
currently running in the systen. This number provides a means of 
uniquely identifying each task. 

Symbolic Debugging Systen MTS 


A program (entered via debug mode) which aids in the conversational 
debugging of programs. See also Debug Node. 


Symbolic Language = See Source Language. 
Symbol Table GC 


A list of the symbols used in a program, together with information 
about their attributes and their use. 


Systen GC 


The computer hardware and/or software necessary for the execution of 
information processing jobs. See also Operating System, Supervisor. 


System Interrupt - See Supervisor Call. 
System Library GC 


A collection of programs and sub-programs available to all users of a 
particular computer system. In MTS, it is the file *LIBRARY which is 
normally searched last during the program loading process. 


S-8 Card MTS 


A special card which must precede all other cards in a batch job. It 
signals the beginning of a new job. This card is so named because 
column 1 contains an S (0-2 punches) and an 8 (8 punch). This card is 
also called a Receipt card since it must be presented (as.a receipt) to 
pick up output from the job. 


Tape - See Magnetic Tape, Paper Tape. 6C 
Task Number - See Supervisor Task Number. MTS 
Temporary File, Scratch File MTS 


A disk file created for the duration of, at most, a single computer 
job. The names of temporary files begin with the scratch file 
character (usually a minus sign "="), Temporary files need not be 
explicitly created with the CREATE command unless they are to be large 
or sequential files; BTS creates a temporary file when it is first 
referenced, if it does not already exist. Temporary files are 
automatically destroyed at sign-off tine. 
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Terminal 6c 


A device attached to a computer system for the input or output of 
programs and data. See also Conversational Terminal. 


Terminal Job Gc 
A computer job submitted from a conversational terminal. 
Terminal Mode = See Conversational Mode, Remote Batch Mode. GC 
Timee-Sharing GC 
A method of operating a computer system so that the time of the central 
processor is shared among a number of users by giving short bursts of 
activity to each in turn. In suitable circumstances, each user can 
operate as if the whole system were dedicated to hin. 


Time Slice Gc 


In a time-sharing system such as MTS, the period during which a program 
is using the CPU. See also Wait. 


Track GC 


The portion of a moving storage medium, such as a drum, tape, or disk 
that is accessible to a read head. 


Translator GC 


A program which converts statements written in one programming language 
to the format of another programming language. 


Trap = See Interrupt. GC . 

Truncate : 6c 
To suppress those digits of a number which are not significant 
according to some predetermined requirement. No correction is applied 
to the remaining digits. Truncation is also used in MTS to eliminate 
any unnecessary space in a file. 

Truncation Error GC 
(1) An error arising from inaccuracy in truncating a numeric result. 
(2) In some contexts, an error arising from using an approximate 

formulation of the original problen. 
TSS - | 360 


Time Sharing. Systes; the IBM operating systen designed to offer 
time-sharing services on the IBM 360/67 computer. 
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UMIST MTS 


University of Michigan Interpretive String Translator; an interactive 
text processing language. 


Unit = See Device. GC 
Unload GC 


(1) See Magnetic Tape Dismounting. 
(2) To remove a program from main storage. 


Update GC 
To modify a master data file with current information according to some 
specified procedure, The term is also used to refer to the current 
information itself, as used in the modification of the file. 

User GC 
A general designation for anyone who uses the facilities of a computer. 

User File - See Permanent File. MIS 


Utility Program GC 


A standard program used for a frequently occurring task; for example, 
sorting, conversion between binary and decimal representation, etc. 


Variable 6C 
A quantity that can assume any of a given set of values. 

Vertical Redundancy Check GC 
A parity check on the bits across the width of a byte or word. 

Virtual Address, Logical Address GC 
An address generated by a program which references virtual memory and 
must therefore be translated into a real storage address when it is 
used. 

Virtual Memory GC 
Memory which appears to the user as though it were all main storage, 
although it may actually be at any time partly in main storage, partly 
on a drum, partly on a disk, and even partly not allocated anywhere (if 


defined, but not referenced), depending on the competing demands for 
storage by other users. See also main storage, Paging. 
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Volume 6c 
A unit of peripheral storage, such as a disk pack or magnetic tape. 

Wait GC 
The condition of a job in a computer system when it has been started, 
but is not currently being worked on by the central processor. A 
common reason for this condition is that the job is waiting for the 
completion of an action by some other component of the system, for 
example, a disk storage unit or other peripheral device. In a 
multiprogramming system, the central processor interleaves work on a 
nuaber of jobs with the waiting periods of any particular job. 

WATFOR 7 GC 
A FORTRAN IV compiler written at the University of Waterloo. It is 
characterized by rapid compilation, extensive error checking at both 
compile and run times, and slow execution, when compared with other 
FORTRAN compilers. WATFOR does not generate an object deck. See also 
FORTRAN G Compiler, FORTRAN H Compiler. 

WATFOR Library MTS 


A set of sub-programs, in the public file *WATLIB, automatically 
available to users of the WATFOR compiler. 


Word - See Fullword. Gc 
9J-edge GC 


The lower edge of a punched card. This is the edge adjacent to the row 
of 9=punches on the card. 


12-edge Gc 


The upper edge of a punched card. This is the edge adjacent to the row 
of 12=punches on the card. 


J-track Magnetic Tape - See seven«track Magnetic Tape. 6c 


Q-track Magnetic Tape - See nine=track Magnetic Tape. GC 
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¢, 80, 85, 96 

+, 64, 166 

+n edit command, 42, 61, 
271, 274, 303 

!, 80, 83, 85, 96, 133, 201, 210 

$ command flag, 16, 38, 98, 99, 
171, 173 

$ indirection operator, 317 

$ or COST DISPLAY command parae 
meter, 204 

$ SET command keyword paraseter, 
253 

$ Xec flag, 269, 272 

SCONTINUE WITH, 114, 169, 2£0 

$ENDFILE, 19, 130, 168, 250 

$name edit command, 269, 274, 304 

S$PERMIT command, 31 

*, SH, 271, 323 

***GLOBAL TIME LIMIT 
ATXXXXXxXXX, 374 

*** LOCAL TISE LIMIT EXCEEDED 
ATXXXXxxxx, 374 

*AFD*, 99, 111, 236, 240, 403 

*ALGOL, 47 

*ALGOLW, 47 

*AMENDS, 135 

*APL, 48 

*ASMG, 48, 309 

*BASIC, 48 

*BATCH*, 33, 89, 99, 
491, 240, 257 

*BLDLIN, 52 

*CATALOG, 31, 51 

*COBOL, 47 

*COPY, 139 

*DOWNDATE, 135 

*DUMMY*, 28, 111, 416 

*P, 54, 271 

*FILESNIFF, 51 

*FMAINT, 52 

*FMT, 52 

*FORTEDIT, 33 

*PORTRANH, 47 

*FTN, 20, 29, 47, 63, 309 


269, 


EXCEEDED 


111, 185, 


*L, S4, 271 
*LIBRARY, 228, 244, 253 
*LIBRARY parameter, 179, 253 
*LISP, 49 
*MSINK*, 99, 111, 198, 227, 243, 
259, 325, 433 
*MSOURCE*, 99, 111, 
243, 260, 325, 433 
*PIL, 48 
*PLAOUT, 52 
*PL1, 47 
*PL360, 48 
*POSTPR, 52 
*PRESCAN, 52 
*PRINT, 52 
*PRINT*, 89, 
240, 257 
*PROJECTACCOUNT, 384 


198, 227, 


99, 111, 185, 191, 


*PUNCH*¥, 28, 89, 99, 111, 185, 
191, 198, 227, 240, 243, 
257, 441 

*REDUCE, 49 

*SINK*, 28, 99, 110, 198, 227, 


243, 259, 446 

*SLIP, 49 

*SNAP, 49 

*SNOBOLY, 49 

*SOURCE*, 28, 99, 110, 171, 198, 
227, 243, 260, 263, 446 

*SPITBOL, 49 

*SPL, 47 

*STASS360, 48 

*STATUS, 31, 51 

*SWAT, 47 

*UMIST, 49 

*UNEDIT, 135 

*WATFOR, 20, 47 

*XPL, 48 

*1, 49 

*1ASR, 48 

*1730ASM, 48 

*8ASR, 48 

*9ASR, 48 

) (network command mode), 166 
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(not sign), 142 
on nodifier, 112 


(minus sign), 80, 99, 130, 
174 
on modifier, 112 
on edit command, 42, 61, 269, 


271, 274, 303 

/ region flag, 270, 272 

/FILE, 54, 266 

fname edit command, 269, 274, 305 

%, 83, 85, 164 

— (underscore), 80, 85, 96 

>, 23, 166 

2, 77, 166 

3, 53, 166, 208 

#, 23, 37, 77, 78, 89, 166 

"closing the file", 163 

“Poname® DOES NOT EXIST., 117 

"FDname" IS INVALID., 118 

"FDOname"™ IS NOT AVAILABLE., 117 

"WHO ARE YOoU?", 93 

A (alter), 180, 269, 274, 275 

A (at), 333, 335 

A device=-type INQUIRE command 

parameter, 177, 219 

A modifier, 59, 270, 310, 317 

type code, 316 

Abbreviations, 175, 269, 332, 397 

ABEND, 403 

Abnormal conditions, 167, 371, 

Abnormal end, 403 

Absolute address, 44 

Abstracts of Available Scftware, 
11 

Access type, 138 

Active file, 22, 99, 129, 
208, 212, 236, 240 

ACTIVE INQUIRE command paraseter, 
177, 215 

ADD projectaccount command, 384, 
398, 399 

Address, 403 

Addressing exception, 371 

AFD DISPLAY command parameter, 
204 

AFDECHO parameter, 178, 248 

AFDNAME DISPLAY command paramet- 
er, 204 

AL (alter), 333, 334 

ALGOL, 47 

ALGOLW, 47 


rod 


171, 
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Algoritha, 403 
ALL INQUIRE 
177, 217 
ALL PERMIT access-type, 138, 238 
Alphameric, 404 
Alphanumeric, 404 
ALREADY DEFINED = ENTER "¥" TO 
REPLACE, "N* TO RETAIN, 267 
ALTER command, 40, 175, 180 
ALTER debug command, 333, 334 
ALTER edit command, 42, 274, 275 
American Standard Code for Infor- 
mation Interchange, #04 
Answerback, 77, 93 
Answering service, 77, 93 
APL, 48, 404 
Application package, 404 
Argument, 404 
Array, 404 
ASCII, 404 
Assemble, 404 
Assemblers, 48, 404 
IBM 1130, 48 
IBM 1800, 48 
IBM 360, 48 
PpP=-1, 48 
PDP=5 or 8, 48 
PDP-7 or 9, 48 
PL360, 48 
STASS 360, 48 
Assignment statement, 311 


command parameter, 


AT, 2461 

AT debug command, 45, 333, 335 

AT“POINTS parameter, 333, 340, 
351 

ATPREFIX SET debug command para- 
meter, 363 


ATT (attribute), 333, 337 

Attention interrupt, 80, 81, 94, 
96, 111, 166, 259, 260, 267, 
324, 373, 397 

ATTN (attntrp), 333 

ATTN CONTROL command parameter, 
191 

ATTN key, 76, 373 

ATTN SET debug command parameter, 
363 

ATTN, 80 

ATTNTRP debug command, 324, 
333 

ATTNTRP subroutine, 252, 373 

ATTRIBOTE debug command, 46, 333, 
337 


332, 
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Automatic error dumping in Batch, 


330 
Automatic line numbering, 129, 
171, 236, 263 
b, 113 
(blank), 269, 274, 276 


(break), 333, 338 
(brief), 298 
INQUIRE command parameter, 177, 
215 
B type code, 316 
BACKSPACE, 80, 85, 96, 405 
Base address, 405 
Base register, 405 
BASIC, 48 
Batch 
“job, 89 
job from a terminal, 89 
job retrieval, 97, 102 
job submission, 35, 97, 102 
mode, 15, 32, 89, 97 
processing, 405 
queue, 405 
station, 35 
stream, 405 
usage, 97 
usage defaults, 98 
Batch-monitor, 102 
BCD, 406 
BCD parameter, 202, 206 
BDCST CONTROL command parameter, 
189 
BDCST device command, 86 
BIN CONTROL command parameter, 
191 
BIN modifier, 145 
Binary, 405 
code, 405 
digit, 406 
format, 406 
read feature, 406 
search, 406 
Binary Coded Decimal, 406 
‘ BIRS, 51 
Bit, 406 
BLANK edit command, 43, 274, 276 
BLANK SET debug command paranmet=- 
er, 363 
BLK CONTROL command parameter, 
189 
BLK MOUNT keyword parameter, 233 
BLKSIZE CONTROL command paranet- 
er, 189 
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BLKSIZE MOUNT keyword parameter, 
234 

Block diagram, 50 

Block parameter, 313 

Blocking, 406 

Blocking factor, 406 

BLOCKING MOUNT keyword parameter, 
233 

Blocks, 162, 388, 406 

Bookstores, 50 

BPI (bit per inch), 406 

BPI macro, 372 

Braces, 175, 273, 332 

Brackets, 175, 273, 332 

BREAK, 80 

BREAK debug command, 45, 67, 333, 
338 

BREAK key, 75, 373 

Breakpoint, 167, 325, 338, 350 
global, 325, 338, 350 
local, 325, 360 

BREAKPOINTS parameter, 333, 
351 

BRIEF parameter, 298 

BRK RLS key, 75 


340, 


BS, 85 

BSF CONTROL command parameter, 
188 

BSR CONTROL command parameter, 
188 

Buffers, 162, 406 

Bug, 407 


Business office, 383 

Bytes, 107, 407 

(cards), 228, 244, 256 

(change), 269, 274, 277 

(checkpoint), 298 

(continue), 333, 342 

(copy), 193 

(count), 272 

INQUIRE command parameter, 177, 
219 

modifier, 68 

type code, 316 

CALC command, 41, 176, 183 

CALCOMP Plot, 407 

CALCOMP Plotter, 11, 407 

Calculating size of file, 156 

Called program, 407 

Calling program, 407 

Calling sequence, 407 

CAN (cancel), 90, 185 

CANCEL command, 176, 185 
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CANCEL CONTROL command parameter, 
191 

CANCEL option, 90 

Cancelling job, 185 

Card, 407 
coluan, 407 
deck, 408 
hopper, 409 
image, 409 
input return codes, 159 
limit, 98 
punch, 99, 409 
reader, 26, 35, 99, 408 
stacker, 408 

‘Cards paraseter, 17, 98, 
179, 228, 264, 256 

Carriage control, 99, 298 

Carriage control character, %08 

Carriage width, 73, 75 

Case conversion, 84, 248 

CASE parameter, 178, 248 

Cathode Ray Tube, 408 

Cathode Ray Tube terminal, 33 

cC CONTROL command paraseter, 
189, 191 

cc modifier, 142, 146 

CC parameter, 298 

CCAP public files, 30, 108 

CCAP: BIRS, 51 

CCAP:CONSTAT, 50 

CCAP:CSMPEXEC, 50 

CCAP: CSMPLIB, 50 

CCAP: CSMPTRAN, 50 

CCAP:GPSS, 50 

CCAP: OSIRIS, 50 

CCAP: PIL2;, 48: 

CCAP:SIMLIB, 50 

CCAP: SI#2, 50 

CCAP:SPSS,. 50 

Ccid, 408 

CCitenos, 9 

CD key, 76 

Central. Processing Unit, 408 

Central Processor, 408 

CH modifier, 267, 270 

CHANGE edit command, 58, 
274,. 277 

Change of password, 99 

Character, 409 

Character code, 409 

Character. string, 409 

CHARGE parameter, 360, 398, 400 

CHE (checkpoint), 269, 274, 278 


178, 


270, 
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CHECK (red) light, 76 

Checkpoint, 409 

Checkpoint buffer, 267 

CHECKPOINT edit command, 44, 134, 
267, 274, 278 

CHECKPOINT paraweter, 298 

Checkpoint/Restore edit facility, 
267 

CHKFPDUB subroutine, 121 

CL (clean), 333, 340 

CLEAN debug command, 45, 70, 333, 
340 

Closing a file, 409 

CLR PAGE button, 95 

CLR“SET rocker switch, 75 

CMDSKP parameter, 178, 248 

CNTR INQUIRE command parameter, 
177, 217 

CNTR parameter, 177 

CNW PERMIT access-type, 138, 238 

CO (copy), 269, 274, 280 

COBOL, 47, 409 

Code, 409 

COL (column), 269, 274, 279 

COL CONTROL command parameter, 
189 

Collate, 409 

Collating sequence, 409 

Collator, 409 

Coluan, 410 : 
binary, 416 
pointer, 265 
range, 265 

COLUMN edit command, 44, 59, 265, 
274, 279 

COM (comment), 187, 333, 341 

COM device command, 85 

Command language, 410 

Command lines, 38, 171, 410 

Command mode, 410 

Commands, 168, 171 

COMMENT command, 41, 
176, 187 

COMMENT debug command, 333, 381 

Common storage area, 410 

Compilation time, 410 

Compile, 410 

Compilers, 48, 410 

Completion code, 410 

Computer card, 410 

Computer graphics, 411 

Computer word, 411 

CON (continue), 398, 399 


163, 172, 
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CON (control), 188 
Concatenate, 411 
Concatenation, 114 
explicit, 37, 115 
implicit, 114, 250 
Concepts, 36 
Condition code, 378 
CONFIG INQUIRE command parameter, 
177, 219 
Console, 411 
Console typewriter, 411 
CONSTAT, 50 
Consulting, 34, 93 
CONT (continue), 236 
CONTCHAR parameter, 131, 178, 248 
Context editing, 42 
Context editor, 53, 134, 163, 265 
Continuation character, 130 
Continuation lines, 174 
CONTINUE debug command, 45, 167, 
323, 333, 342 
CONTINUE parameter, 236 
CONTINUE projectaccount command, 
386, 398, 399 
Continuous System 
gram, 411 
Control card, 411 
Control characters, 79, 93, 96, 
411 
CONTROL command, 41, 83, 90, 176, 
188 
CONTROL command parameters 
ATTN, 191 
BDCST, 189 
BIN, 191 
BLK, 189 
BLKSIZE, 188 
BSF, 188 
BSR, 188 
CANCEL, 191 
cc, 189, 191 
COPIES, 191 
COL, 189 
CROUTE, 191 
pec, 189 
DLC, 189 
DON'T, 191 
DSN, 189 
EFC, 190 
BOF, 191 
FMT, 188 
FORMAT, 188 
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PSF, 188 
FSR, 188 
GOLF, 190 
HEX, 190, 191 
HOLD, 191 
JOB, 190 
K, 190 
LEN, 190, 191 
LMAR, 190 
LNC, 190 
LP, 189 
LRECL, 189 
MODE, 189 
NAME, 191 
NOTE, 190 
PFX, 191 
POP, 189 
POSN, 188 
PRINT, 191 
PROUTE, 191 
PUSH, 189 
RECFM, 188 
RELEASE, 191 
RESET, 190 
RETRY, 189 
REV, 190 
REW, 188 
RMAR, 190 
ROUTE, 191 
SIZE, 188 
TAB, 191 
TABI, 190 
TABO, 190 
TERSE, 190 
uc, 191 
UcI, 190 
uco, 190 
WARN, 190 
WIM, 189 
Control prograa, 411 
Control statement, 311 
CONTROL subroutine, 121, 188 
CONTROL-C, 80, 85, 94 
CONTROL-E, 94 
CONTROL“H, 79, 80, 85, 94 
CONTROL=I, 84 
CONTROL“-N, 80, 85, 94 
CONTROL=“9, 94 
CONTROL@S, 80, 94 
CONTROL@Z, 80, 85, 94 
Conversational, 411 
mode, 15, 32, 73, 89, 412 
operation, 78, 98 
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terminal, 412 
usage, 73 

Converter, 412 

COPIES CONTROL command parameter, 
191 

COPIES option, 90 

COPIES parameter, 98, 179, 257 

COPY command, 20, 25, 41, 129, 
132, 176, 193 

COPY edit command, 43, 278, 280 

Copying command mode, 168 

Core storage, 37 

Cost of job, 101 

COST parameter, 178, 249 

Counseling, 34, 93 

COUNT parameter, 272 

CPU, 408 

CPU bound, 4142 

CPU time, 412 

CPU tize lisit, 98 

CR (create), 196 

CREAFD parameter, 178, 249 

CREATE command, 20, 40, 127, 171, 
176, 196 

Creating files, 127 

Cross-reference listing, 412 

CROUTE CONTROL command parameter, 
191 

CROUTE option, 90 

CROUTE parameter, 98, 179, 257 

CRT, 408 

- CS (csect), 333, 343 

CSECT debug conmand, 46, 67, 315, 
329, 333, 343 

CSMP, 49, 412 

CTRL key, 74 

CUINFO subroutine, 131, 169, 174, 
248 

Current active file, 22, 
208, 212, 236, 240 

Current line, 271 

Current line pointer, 42 

Current symbol character, 323 

Cycle time, 412 

D (delete), 269, 274, 281 

D (display), 202, 333, 348 

D device-name INQUIRE command 
parameter, 177, 219 

D modifier, 311, 317 

Data 


171, 


exception, 371 
lines, 171, 413 
record, 413 
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section, 156 
set, 413 

DATA CHECK, 82 

DBLS parameter, 202, 206 

DCC CONTROL command parameter, 
189 

pcc device command, 83, 85 

DE (destroy), 201 

DEB (debug), 198 

Debug, 33, 413 

DEBUG command, 40, 63, 176, 198, 
307 

Debug command definition, 332 

Debug command prototypes summary, 
333 

Debug coamands 
ALTER, 333, 334 
AT, 45, 333, 335 
ATTNTRP, 324, 332, 333 
ATTRIBUTE, 46, 333, 337 
BREAK, 45, 67, 333, 338 
CLEAN, 45, 70, 333, 340 
COMMENT, 333, 341 
CONTINGE, 45, 323, 333, 342 


CSECT, 46, 67, 329, 333, 343 

DISPLAY, 46, 68, 313, 333, 
344 

DROP, 333, 345 

DSECT, 329 


DUMP, 46, 333, 346 

END, 45, 333, 347 

ERROR, 323 

GOTO, 45, 324, 333, 348 

HEXDISPLAY, 46, 333, 349 

IGNORE, 333, 350 

INPUT, 332, 333 

LENGTH, 332, 333 

LINK, 324 

LIST, 333, 351 

LOAD, 324 

MAP, 46, 333, 352 

MODIFY, 4&6, 70, 
354 

MTS, 45, 323, 333, 356 

MTSCMD, 323 

OUTPUT, 332, 333 

PGNTTRP, 324, 332, 333 

PREFIX, 332, 333 

QUALIFY, 333, 357 

RESET, 46, 333, 358 

RESTORE, 45, 70, 333, 359 

RF, 332, 333 

RUN, 45, 66, 324, 333, 360 
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SCALE, 332, 333 
SCAN, 46, 318, 333, 361 
SDS, 45, 333, 362 
SET, 46, 308, 333, 363 
STEP, 45, 326, 333, 366 
STOP, 45, 333, 367 
SYMBOL, 46, 333, 368 
SYSTEM, 323 
TERSE, 332, 333 
TYPE, 332, 333 
USING, 46, 333, 369 
XCTL, 324 
Debug mode, 167, 307, 413 
DEBUG parameter, 178, 249 
Debugging, 307 
Debugging commands, 40, 307, 333 
Debugging FORTRAN program, 63 
Debugging program, 375 
Decimal divide exception, 371 
Decimal overflow exception, 371 
Deck, 413 
Default definition, 413 
Default I/0 Unit assignments, 413 
Default option, 413 
Defaults 
batch, 98 
case conversion, 88 
character, 94, 96 
logical I/O units, 120 
pseudo-device names, 98, 257 
SDS parameters, 358 
signon, 98 
DELETE edit command, 43, 55, 274, 
281 
Delete line character, 79, 80, 
85, 88, 94, 96 
Delete previous character, 79, 
80, 85, 88, 94, 96 
Delimiter character, 271 
Delimiters, 168, 413 
ende-of-file, 169 
implicit concatenation, 169 
Delivery code, 16, 101, 257 
DEMO public files, 108 
Density, 414 
DEST MOUNT keyword parameter, 234 
DESTROY command, 20, 40, 98, 133, 
171, 176, 201 
DEVCHAR parameter, 112, 178, 249 
Device command character, 83, 85 
Device commands, 82, 414 
BDCST, 86 
COM, 85 
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pcc, 83, 85 
DLC, 85 
pec, 85 
EFC, 85 
GOLF, 84 
HEX, 85 
K, 84 
LEN, 86 
LMAR, 83 
LNC, 85 
RESET, 86 
RMAR, 83 
TABI, 84 
TABO, 84 
WARN, 86 
Device name, 36, 414 
Device Support Routines, 82, 88, 
414 
Devices, 107, 109, 414 
Diagnostic, 414 
Digital Computer, 414 
Digital Incremental Plotter, 415 
Direct access, 415 
Direct access device, 415 
Direct access file, 415 
Disc, 415 
Disk, 415 
DISK parameter, 390, 398, 400 
Disk space, 383 
Dismounting, 415 
Displacement, 309, 415 
Display and Modify processing, 
309 
DISPLAY command, 40, 
202 
DISPLAY debug command, 
313, 333, 344 
Display unit, 416 
DLC CONTROL command parameter, 
189 
DLC device command, 85, 94, 96 
DO (document), 269, 274, 282 
DOCUMENT edit command, 274, 282 
Documentation, 9, 11 
Documentation aids, 52 
DON'T CONTROL command parameter, 
191 
Dots, 175, 273, 332 
Double precision, 416 
Double word, 416 
DPC CONTROL command parameter, 
189 
DPC device command, 85, 94, 96 


175, 176, 


86, 68, 
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DR (drop), 333, 385 

Drive, 416 

DROP debug command, 333, 345 

Drua, 416 

DSECT debug command, 315, 329 

DSECT parameter, 333, 352 

DSN CONTROL command parasgeter, 
189 

DSN MOUNT keyword parareter, 233 

DSNAME MOUNT keyword parasgeter, 
233 

DSPC parameter, 202, 206 

DSR, 82, 88, 416 

DU (dump), 206, 333, 346 

Dumay parareter, 416 

Duaay routine, 416 

Dumany variable, 417 

Dump, 250, &17 

DUMP command, 40, 176, 206 

DUMP debug command, 46, 333, 346 

Duplex systea, 417 

Dynamic loading, 323 

e, 113 

(echo), 298 

(empty), 210 

(end), 333, 347 

(endoffile), 268 

(explain), 269, 278, 284 

type code, 316 

EBCD modifier, 145 

EBCD parameter, 202, 206 

EBCDIC, 417 

ECHO parameter, 178, 249, 298 

ED (edit), 208, 269, 278, 283 

EDIT command, 41, 53, 176, 208, 
265 

Edit command definitions, 272 

Edit command keyword parameters, 
272 

Fdit command sode, 167 

Edit command names, 269 

Edit command prototypes summary, 
274 

Edit commands, 53 
$name, 274, 304 
fname, 274, 305 
BLANK, 43, 274, 276 
CHANGE, 58, 270, 274, 277 
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CHECKPOINT, 44, 134, 267, 
278, 278 

COLUMN, 44, 59, 265, 274, 
279 
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COPY, 43, 274, 280 

DELETE, 43, 55, 274, 281 

DOCUMENT, 274, 282 

EDIT, 43, 274, 283 

EXPLAIN, 48, 274, 2884 

GOTO, 274, 285 

INSERT, 43, 55, 56, 274, 286 

LINE, 42, 274, 287 

MATCH, 54, 60, 274, 288 

MTS, 43, 274, 289 

n (¢ or =), 42, 61, 
271, 274, 303 

OVERLAY, 43, 60, 274, 290 

PRINT, 44, 274, 291 

REGION, 43, 272, 274, 293 

RENUMBER, %4&, 274, 294 


269, 


REPLACE, 43, 55, 56, 274, 
295 

RESTORE, 44, 134, 267, 274, 
296 

SCAN, 42, 54, 60, 270, 274, 
297 


SET, 43, 274, 298 
SHIFT, 43, 274, 300 
STOP, 43, 274, 301 
XEC, 43, 274, 302 & 
EDIT edit command, 43, 274, 283 
Edit mode, 56, 265, 417 
EDITAFD parameter, 178, 208, 249 
Editing file, 53 
Editor, 42, 53, 417 
EFC CONTROL command parameter, 
190 
EFC device command, 85, 94, 96 
Elapsed time, 417 
EMPTY command, 
176, 210 
EMPTY subroutine, 121 
END debug command, 45, 333, 347 
END edit pseudo~command, 268 
End-of-file, 268, 417 
character, 79, 80, 85, 94, 
96 


25, 41, 98, 133, 


condition, 169 

mark, 418 
End-of-line character, 80 
End-ofereel marker, 418 
End-of-tape marker, 418 
Endfile delimiter, 169 
ENDFILE parameter, 178, 250 
ENDFILE switch, 169, 178 
ENDOFPFILE, 268 
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ENTER NEW COMMAND OR "eft TO 
RETAIN, 268 

ENTEP REPLACEMENT OR CANCEL, 117 

ENTIRE parameter, 388, 398 

Entry point, 418 

ENTRY SET debug command paranet=- 
er, 363 

FOF (endoffile)., 268, 418 

EOF CONTROL command paraneter, 
191 

EQU (equalize), 398, 399 

EQUALIZE projectaccount command, 
385, 398, 399 

ER (errordump), 211 

ER (errorexit), 298 

ERR (errorexit), 298 

ERROR (errorexit), 298 

Error conditions, 82 

ERROR debug command, 323 

Error message, 418 

Error processing, 117 

ERROR subroutine, 166 

Error-dumping in batch, 330 

ERRORDUMP command, 40, 71, 98, 
174, 176, 211, 375 

Errorduap in batch, 377 


ERRORDUMP parameter, 98, 174, 
178, 250 

ERRORDUMP SET debug command para- 
meter, 363 


ERRORDUMP switch, 174, 178 
FRROREXIT parameter, 298 
ERRRTN modifier, 151, 154, 375 
ERS, 333 
Estimated size of file, 196 
ETX, 94 
EXEC INQUIRE command paranreter, 

177, 217 
EXEC parameter, 177 
Executable statement, 418 
Execute, 418 
Execute exception, 371 
Execution 

mode, 166 

phase, 103 

priority, 103 

queue, 103 

table, 104 
EXECUTION BEGINS, 245 
EXECUTION TERMINATED, 245 
Execution time, 26, 418 
EXP (expire), 398, 399 
Expiration time, 383 
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EXPIRE parameter, 392, 400 
EXPIRE projectaccount command, 
385, 398, 399 


EXPLAIN edit command, 44, 274, 
284 

Explicit concatenation, 37, 115, 
418 


Exponent overflow exception, 371 

Exponent underflow exception, 371 

Extended Binary Coded Decimal 
Interchange Code, 418 

Extent, 419 

External symbol resolution, 419 

F (failure), 268 

F (£111), 298 

F type code, 316 

Facilities and Services (manual), 
11, 16 

FAILURE, 268 

Fast-insert mode, 57 

Fpname, 36, 107, 112, 116, 
193, 225, 259, 260, 419 

FDUB pointer, 118, 120, 154 

Fetch protection, 419 

Field, 419 

FILE "“name* IS TO BE DESTROYED. 
PLEASE CONFIRM., 133 

FILE "name" IS TO BE EMPTIED. 
PLEASE CONFIRM., 133 

FILE "name": SIZE EXCEEDED, 129 

File Extent, 419 

File or Device name, 36, 107 

File or Device Usage Block, 120 

FILE parameter, 398, 400 

File protect ring, 419 

Files, 20, 107, 419 
approximate size, 196 
copying, 24 
creating, 21 
discovering changes, 135 
handling commands, 40 
library, 427 


118, 


line, 21, 122, 155, 196, 
5, 427 

making chanes, 131 

name, 36, 108 

permanent, 33, 108, 438 

permitting, 138, 238 

private, 29, 30, 108, 201, 


439 
protection, 419 
public, 36, 108, 441 
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putting information 
129 
restoring, 134 
revising, 24 
scratch, 30, 108, 4&5 
sequential, 122, 125, 
156, 196 © 
sequential with line number, 
122, 196 
support routine, 88 
temporary, 30, 108, 201, 449 
updating, 53, 162 
FILECHAR parameter, 112, 178, 250 
Filemark, 419 
Pill character, 298 
FILL parameter, 298 
FINAL DELIMITER?, 271 
First line of the file, 271 
Fixed point, 420 
Fixed-point divide exception, 371 
Fixed-point overflow exception, 
371 
FIXEDOVERFLOW, 373 
Flag, 420 
Ploating point, 420 
Floating-divide exception, 371 
Flowchart, %20 
FHT CONTROL command parameter, 
188 
FMT MOUNT keyword parameter, 233 
FORMAT CONTROL command parameter, 
188 
FORMAT 
233 
Format, 420 
Formula for calculating 
file, 156 
PORTRAN, 18, 47, 420 
FORTRAN G compiler, 420 
FORTRAN H compiler, 420 
FORTRAN-callable, %20 
FREEFD subroutine, 121, 163 
FROM, 176, 193 
FRS, 333 
FRx DISPLAY cosmand parameter, 
203 
FRx parameter, 180 
FSF CONTROL command paraseter, 


into, 


153, 


MOUNT keyword parameter, 


size of 


188 

FSR CONTROL command parameter, 
188 

FULL, 250 


FULL parameter, 333, 352 
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Full-duplex mode, 74 

FULL“DUPLEX switch, 95 

Fullword, 421 

G (get), 212 

G (goto), 269, 274, 285, 333, 348 
GDINF subroutine, 121 

GDINFO subroutine, 121 


GET command, 22, 41, 129, 171, 
176, 212 

GETFD subroutine, 121 

GETIME subroutine, 375 

GETLINE# modifier, 148 

GFINF subroutine, 121 

Global breakpoint, 325, 338, 350 
Global lisit, 98, 174 

Global relocation factor, 175, 


175, 214, 281, 251 

Global time limit, 374, 421 

GO, 77, 93 

GOLF CONTROL command parameter, 
190 

GOLF device command, 84 

Golf-ball, 75 

GOTO debug command, 45, 167, 324, 
333, 348 

GOTO edit command, 267, 274, 285 

GPSS, 50, 421 

Graphics, 421 


GRx, 180, 203, 213, 214 
GUINFO subroutine, 169, 248, 375 
GUSER, 198, 421 


GUSER subroutine, 228, 244 

H (hex), 299 

BH (hexadd), 213 

H (hexdisplay), 333, 3489 

H (hold), 90 

H INQUIRE command parameter, 177, 
219 

Ralf-duplex anode, 74 

HALF=DUPLEX switch, 95 

Halfvord, 421 

Halfword integer, 421 

Hardware, 421 

HASP, 102, 185, 421 

Hasp Batch mode, 422 

Hasp Batch rmonitor, 422 

HASP batch queue, 99 

Hasp priority, 422 

Header-sheet, 101 

HEADING parameter, 396, 398, 400 

HELD INQUIRE command paraaeter, 
177, 215 

HELD parameter, 177 
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HELP public files, 30, 51, 108 
HELP: DELIVERY, 51 
HELP:DIRECTORY, 51 
HELP: HELP, 51 
HELP: HOURS, 52 
HELP: NEWS, 52 
HELP:RATES, 51 


Hex, 422 
HEX CONTROL command parameter, 
190, 191 


HEX device command, 8&5 

HEX parameter, 202, 206, 299 
HEXADD command, 40, 176, 213 
Hexadecimal, 422 

Hexadecimal conversion nodifier, 


270 

Hexadecimal dump, 375 

HEXDISPLAY debug command, 46, 
333, 349 


HEXS (hexsub), 214 

HEXSUB command, 40, 177, 214 

High-level, 422 

HOLD CONTROL 
191 

HOLD INQUIRE command parameter, 
177, 215 

HOLD option, 90 

HOLD parameter, 177 

Hollerith, 422 


command parameter, 


code, 422 
Hopper, 422 
Houston Automatic Spooling 


Priority System, 102 

HPTR device type, 143 

i, 113 

I (ignore), 333, 350 

IT (inquire), 215 

I (insert), 269, 274, 286 

I modifier, 143, 194 

I type code, 316 

Ifo, 425 
bound, 425 
modifier, 140, 425 
return codes, 158 
interrupt, 324 
errors, 375 
routines, 375 

IBM manuals, 13 

Ic modifier, 151, 169, 250, 265 

Ic parameter, 178, 250 

Ic switch, 169, 250 

ID, 422 : 

Idle mode, 78 
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IGNORE, 391, 392 
IGNORE debug coamand, 333, 350 
Image, 422 
Immediate value, 422 
Implicit concatenation, 114, 250, 
422 
Implicit concatenation delimiter, 
169 
Iaprecise exception, 372 
IN (input), 333 
Increment, 236 
INDCH SET debug command paramet= 
er, 363 
Index, 309 
Indexed, 122 
Indexed operation, 123 
Indexing operation, 310 
Indirection, 317 
Information, 51 
Information files, 51 
Information retrieval, 51 
Initial program load, 423 
Input, 423 
conversion, 318 
device, 423 
file, 423 
phase, 103 
record, 423 
restriction, 80 
station, 98 
INPUT debug command, 332, 333 
INPUT SET debug command paraaret- 
er, 363 
Input/Output, 432 
Input/Output device, 423 
INQUIRE command, 42, 105, 
215 
INQUIRE command parameters 
A device-type, 219 
ACTIVE, 215 
ALL, 217 
Be, 215 
C, 219 
CNTR, 217 
CONFIG, 219 
D device-name, 219 
EXEC, 217 
H, 219 
HELD, 215 
HOLD, 215 
JOB, 215 
L, 219 
LOCAL, 217 


177, 
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M, 220 

ME, 215 

MTS, 222 

N, 220 

0, 220. 

os, 215 

PAGES, 220 ~ 

PLOT, 216 

PRINT, 217 

PRIORITY, 220 

PONCH, 217 

QUE, 217 

receipt=-number, 216 

renote-station-id, 218 

REMOTES, 218 

RANTS, 218 

S$, 220 

SAME, 216 

SIGMSG, 220 

signoneid, 216 

STATUS, 221 

STRANDS, 221 

T device-type, 219 

TAPES, 219 

task-nurgber, 220 

U0 signon id, 220 

USERS, 221 
INSERT edit command, 4%3, 55S, 56, 

274, 286 
Instruction, 423 
InT, 80 
Integer variable, 424 
Inter-record gap, 424 
Interactive, 424 
Interactive computer 

424 
Interactive languages, 48 

APL, 48 

BASIC, 48 

PIL, 48 

REDUCE, 4&9 
Interactive tersinal, 428 
Interblock gap, 424 
Internal representation, 924 
Internal statement number, 424 
Interpret, 824 
Interpreters, 48, 428 
Interrupt code, 371, 378, 425 
Interrupt mask, 425 
Interrupt processing, 323 
Interrupts, 424 


graphics, 
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attention, 80, 81, 94, 96, 
111, 166, 359, 260, 
373, 397 
program, 167, 211, 371, 373 
timer, 324, 374 
Invalid address, 371 
INVALID COMMAND, 173 
IPL, 425 
Irrecoverable I/O error, 425 
ISN, 425 . 
JCL, 425 
Job, 425 
JOB CONTROL copmand parameter, 
190 
Job control langnage, 426 
Job deck, 426 ; 
JOB INQUIRE comsand paraneter, 
177, 215 
JOB parameter, 177 
Justify, 926 
K, 426 
K CONTROL command parameter, 190 
K device command, 84 
Key, 426 
Keyboard, 75, 76 
Keypunch, 426 
Keyword sodifiers, 314 
Keyword parameter, 426 
(line), 269, 274, 287 
(linenuaber), 299 
(list), 225, 333, 351 
(long), 203, 206 
(S|8&Z] INQUIRE comrmand paramet- 
er, 177, 219 
L aodifier, 270 
L type code, 316 
Label, 426 
TABEL MOUNT keyword parameter, 
34 
Language translators, 47 
LAST, 115, 125, 236 
Last line of the file, 271 
LC, 178, 248 
LC aodifier, 145 
LCL-COM switch, 95 
LCL°RAT rocker switch, 74 
LCSYMBOL, 250 
LE (length), 333 
Left justify, 427 
LEN CONTROL command parameter, 
190, 191 
LEN device command, 86 
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LEN SET debug command parasmeter, 
364 
LENGTH debug command, 332, 333 
LIB parameter, 176, 207 
LIBR parameter, 178, 250 
LIBR switch, 178, 250 
Library file, 427 
Library programs, 427 
Library search, 250 
LIBSRCH parameter, 178, 250 
Light pen, 427 
Limit, 98, 227, 242, 244 
global card, 98 
global page, 98, 174 
global punch, 98, 174 
global time, 98, 174%, 378% 
local page, 174 
local punch, 174 
local tine, 174, 37% 
Linits, 261 
Line, 107, 122, 196, 427 
directory, 156 
file, 122, 155, 196, 427 
file editor, 42 
number, 172, 236, 271, 427 
number editing, 42 
number ranges, 113, 427 
number separator, 132, 
251 
printer, 99, 428 
region, 266 
termination character, 88 
edit command, 42, 271, 274, 
287 
LINE FEED key, 75 
LINE switch, 74, 93, 95 
LINENUMBER parameter, 299 
Linenumber prefixing modifier, 
270 
LINK debug command, 324 
LINK SUBROUTINE, 167, 241 
Linkage Editor, 4&28 
LISP, 49 
List and string processing lan- 
guages, 49 
*1, 49 
LISP, 49 
SLIP, 49 
SNAP, 49 
SNOBOL&, 49 
UMIST, 49 
LIST command, 20, 22, 41, 
225 


172, 


LINE 


177, 
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LIST debug command, 333, 351 
List processing languages, 49 
Listing, 428 

Literal, 428 


Literal next character, 80, 85, 
88, 94, 96 

LMAR CONTROL command parameter, 
190 


LMAR device command, 83 
LNC CONTROL command parameter, 
190 
LNC device command, 85, 94, 96 
LNS parameter, 132, 178, 251 
LO (load), 227 
Load, 428 
map, 375, 428 
module, 428 
point, 428 
point marker, 428 
LOAD command, 39, 174, 
LOAD debug command, 324 
LOAD SUBROUTINE, 167, 281 
Load time, 428 
Loader, 428 
Loader syabol table, 252 
Loading command mode, 168 
Loading routine, 429 
Local batch, 35, 102 
Local breakpoint, 325, 360 
LOCAL INQUIRE command parameter, 
177, 217 
Local limit, 174 
Local relocation 
203, 241 
LOCAL switch, 74 
Local time limit, 374, 429 
Location, 429 
Logical address, 429 
Logical carriage control, 429 
Logical I/O anits, 26, 36, 
1938, 227, 241, 243, 429 
defaults, 120 
GUSER, 119, 120 
SCARDS, 119, 120 
SERCOM, 119, 120 
SPRINT, 119, 120 
SPUNCH, 119, 120 
0-19, 119, 420 
Logical record, 429 
Logical unit, 429 
Logical unit number, 429 
LOST DATA, 82 
Lowelevel, 429 


177, 227 


factor, 175, 


118, 
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Low-order position, 429 
Lower case,, 175, 273,. 332. 


LP CONTROL comsand: parameter, 189. 


LP. MOUNT keyword parameter, 233 

lpar, 272, 274%: 

LRECL CONTROL command parameter, 
189 


LRECL MOUNT keyword. paraneter,. 


233 
= (match),. 269,. 27%, 288: 
(ainutes),. 228, 264, 256. 
(nodify), 230, 333, 354: 
» INQUIRE command: paraseter, 177, 
220. 
M type code,. 316 
MA (map), 333, 352. 
Machine carriage control, 429 
Machine language,. 430° 
Machine word, 430 ' 
Macro, 430 
Macro instruction, 430 
Macro Library, 430 
Magnetic disk, 430 
Magnetic drug, 430 
Magnetic tape, 36,. 430 
density, 430 
dismounting, 430 
drive, 430 
file mark, 431 
label, 431 
mode, 431 
mounting, 431: 
reel, 431 
return codes, 159. 
rewind, 531 
ring, 431 
Main storage, 37 
Main-line program, 431: 
Maneals,. 9 
MAP debug. command, 46, 333, 352 
MAP parameter, 177, 178, 
198,. 227, 241, 243, 2617: 
Map, 432 
MAR REL key,.75 
Margin: stops,. 75 
Mask,, 432. 
MATCH edit. command, 54, 60, 
274, 288. . 
mcc nodifier,. 142,. 150 


te oR oe 


271, 


ME INQUIRE command. paraneter,. 


177, 215 
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MEMOREX Transmission Control, 36, 
MEMOREX fransaission Control 
unit, 36. 
Memory, 432 
Memory map, 432 
Memory protect, 432 
Memory protection, 432 
MERIT computer network, 167 
MERIT NETWORK return codes,. 160 
Michigan Terrinal Systems, 432 
MIXED, 178, 248: 
MNEM parameter, 202, 206 
MNET MOUNT device-type, 231 
MOD (modify), 398,. 399 
MODCH SET debug command pararzet~ 
er, 364 
Mode, 166, 167, 168, 432 
MODE CONTROL. command paraneter, 
189 
MODE MOUNT keyword. parameter, 233 
Mode of operation,. 432 
Model 33 Teletype, 35, 73 
Model 35 Teletype, 35, 73 
Modifiers, 37, 53, 1972, 180, 142, 
432 
~ to reverse sense, 112 
- to reverse sense, 112 
A, 59, 270, 310, 317 
BINARY (BIN), 145 
Cc, 68 
CASECONV (DC), 142, 145 
CC, 142, 146 
CH, 267, 270 
D, 3114, 317 
EBCD, 185 
ERRRTN, 157,154, 375 
GETLINE#, 148 
I, 198 
Ic, 15%, 250, 265 
INDEXED (i), 143 
L, 270 
LOWERCASE (LC), 145 
MACHCARCNTRL (NCC), 142, 150 
NCH, 267, 270 
NL, 53, 270 
NOCARCNTRL (NOCC), 146 
NOTIFY, 152 
NV, 270 
NX, 270 
PEEL, 148 
PRIFIX (pfx), 146 
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Q, 317 

R, 310, 317 

RETURNLINE#, 148 

SEQUENTIAL (s), 143 

SPECIAL (SP), 151 

STACKERSELECT (SS), 146 

TRIM, 142, 150, 253, 265 

TYPE, 316, 319 

Vv, 270 

X, 270, 311, 317 
MODIFY command, 40, 175, 178, 230 
MODIFY debug command, 46, 70, 

318, 333, 354 
MODIFY projectaccount 

385, 398, 399 
Module, 433 
Monitor, 433 
MOU (mount), 231 
MOUNT command, 42, 178, 231 
MOUNT keyword parameters 

BLK, 233 

BLKSIZE, 234 

BLOCKING, 233 

DEST, 234 

FMT, 233 

FORMAT, 233 

LABEL, 234 

LP, 233 

LRECL, 233 

MODE, 233 

NEWEXP, 233 

NEWRPW, 233 

NEWWPW, 233 

OVRIDE, 233 

POSN, 233 

QUIT, 233, 234 

RECPM, 233 

RERUN, 233 

RETRY, 233 

RING, 233 

RPW, 233 

SIZE, 2348 

VOL, 234 

VOLSER, 234 

VOLUME, 234 

WPW, 234 

WRITE, 234 
Mounting, 433 
MT (ats), 269, 274, 289, 333, 356 
MTS, 433 
MTS command, 433 
MTS command node, 

171, 833 


command, 


53, 61, 166, 
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MTS command prototypes summary, 
175 

MTS debug command, 45, 323, 333, 
356 

MTS edit command, 43, 167, 274, 
289 


MTS GLOBAL CONTROL COMMANDS, 39 
MTS INQUIRE command parameter, 
177 
MTS monitor, 171 
MTS network command, 167 
MTS notation conventions, 175 
MTS subroutine, 166 
MTSCMD debug command, 323 
MTSCMD subroutine, 166 
Multi-level storage system, 433 
Multi-processing system, 434 
Multi-programming systen, 433 
MX, 178, 248 
n (* or -) edit command, 42, 61, 
269, 271, 274, 303 
(name), 90 
(number), 236 
INQUIRE command parameter, 177, 
220 
N parameter, 177 
NAME CONTROL command parameter, 
191 
NAME option, 90 
NCH modifier, 267, 270 
NE (net), 235 
Nesting, 434 
NET command, 42, 167, 178, 235 
Network command mode, 167 
NEVER, 178, 250 
NEWEXP MOUNT keyword parameter, 
233 
NEWRPW MOUNT keyword parameter, 
3 


Le -e-} 


NEWS public files, 108 

NEWWPW MOUNT keyword parameter, 
233 

Nine-track magnetic tape, 434 

Nine-track magnetic tape drive, 
434 

NL modifier, 53, 270 

NOBCD parameter, 202, 205 

NOCC sodifier, 146 

NOCHANGE parameter, 394, 398, 400 

NOEBCD parameter, 202, 206 

NOHEAD parameter, 398, 400 

NOHEX parameter, 202, 206 

NOLIB parameter, 206 
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NOLIST parameter, 396, 398, 400 
NOMAP parameter, 177, 178, 179, 
198, 227, 241, 243, 261 

NOMNEM parameter, 202, 206 

Non-numeric character, 438 

Non=printing graphics, 434 

NONE PERMIT access-type, 138, 238 

NOTE CONTROL command paraageter, 
190 

NOTE subroutine, 121, 154 

NOTIFY modifier, 152 

NUMBER command, 21, 41, 171, 178, 
236 

NV modifier, 270 

NX modifier, 270 

0 (outpat), 333 

O (overlay), 269, 274, 290 

O INQUIRE command parameter, 177, 
220 

O.K., 32, 133, 201, 210 

Object code, 434 

Object deck, 434 

Object file, 434 

Object language, 434 

Object module, 435 

Object program, 18, 36, 435 

Object time, 435 

Octal, 435 

OFF switch, 74 

Off-line, 435 

OK, 32, 201, 210 

OLD public files, 108 

OMAPCH SET debug command paranet= 
er, 368 

Omission of the $SIGNOFF command, 
100 

OMR, 435 

ON, 176, 202, 206, 225 

OWN FDnarme, 202 

ON switch, 93, 95 

ON-condition, 373 

On-demand system, 435 

On-line, 435 

ON-OFF rocker switch, 74 

Opening a file, 435 

Operating sytes, 435 

Operation exception, 371 

Operator's console, 435 

ORL parameter, 203, 206 

OS, 436 

OS INQUIRE 
177, 215 

OSIRIS, 50 


command paraseter, 
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Output, 436 

Output conversion, 322 

OUTPUT debug command, 332, 333 

Output device, 436 

Output record, 436 

Output routing, 101 

OUTPUT SET debug command paranet- 
er, 364 

Output station, 98 

OVERFLOW(newsletter), 9 

OVERFLOW, 373 


OVERLAY edit command, 43, 60, 
274, 290 

OVRIDE MOUNT keyword . parameter, 
233 

P (pages), 196, 228, 244, 256 

P (print), 269, 274, 291 


P type code, 316, 316 

Padding, 436 

Page, 436 

Page limit, 98 

PAGES INQUIFE command parameter, 

177, 220 

parameter, 17, 98, 

178, 179, 228, 244, 256 

Paging, 37, 436 

Paper tape, 437 

Paper tape punch, 437 

Paper tape reader, 437 

Paper tape transmission code, 437 

PAR parameter, 227, 243 

PAR SET debug command parameter, 
364 

Parameter, 437 

Parity bit, 437 

PAS (password), 398, 399 

Password, 16, 99, 251, 256, 437 

Password card, 437 

Password lost, 387 

PASSWORD projectaccount command, 
387, 398, 399 

Password retrieval, 387 

Pc modifier, 270 

PDN, 438 

PE (permit), 238 

PEEL modifier, 148 

Peripheral unit, 438 

Permanent file, 33, 108, 438 

Permit code, 438 

PERMIT command, 41, 138, 178, 238 

PFX CONTROL command parameter, 
191. _ 

PFX modifier, 146 


Pages 177, 


April 1974 


PPX parameter, 178, 251 

PFX switch, 178, 237, 251 

PG (pgnttrp), 333 

PGNT SET debug command paraneter, 
364 

PGNTTRP debug command, 324, 
333 

PGNTTRP subroutine, 372 

Phone numbers, 76, 77, 93, 95 

Physical blocks, 162 

Physical record, 438 

PIL, 48, 438 

PL/I, 47, 438 

PL/I library, 438 

PLOT INQUIRE command parareter, 
177, 216 

PLOT parameter, 
400 

PLOTHRS parameter, 392, 398, 400 

Plotter, 438 

POINT subroutine, 121, 154 

Pointers, 153 

POP CONTROL 
189 

Portacon, 73 

Positional parameter, 438 

POSN MOUNT keyword parameter, 233 

POSNCONTROL command paraneter, 
188 

PR (prefix), 333 

Precision, 439 

Predefined symbol, 317 

Prefix character, 22, 37, 53, 57, 
64, 78, 165, 166, 251, 307, 
439 

PREPIX debug command, 332, 333 

PREFIX SET debug command pararet=- 
er, 365 

Preprocessor, 439 

PREVIOUS parameter, 179, 259, 260 

Print column nodifier, 270 

PRINT CONTROL command paraneter, 


332, 


177, 391, 398, 


command paraseter, 


191 

PRINT edit command, 44, 53, 274, 
291 

PRINT INQUIRE command paraneter, 
177, 217 


PRINT option, 90 

PRINT parameter, 98, 
257 

Print phase, 103 

Print priority, 103 

Print queue, 103 


177, 179, 
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Print table, 104 
Printed output, 36, 101 
Printed output copies, 98 
Printed output return codes, 160 
Printer, 439 
Printer character set, 98 
Printer plot, 439 
Priorities, 104, 439 
PRIORITY INQUIRE command paranet= 
er, 177, 220 
Private file, 29, 108, 201, 439 
Privileged operation exception, 
371 
PRINO PERMIT access=type, 138, 
238 
Problem state, 439 
Procedure-oriented languages, 47, 
439 
ALGOL, 47 
ALGOLW, 47 
COBOL, 47 
FORTRAN IV, 47 
PL/I, 47 
SPL, 47 
WATFOR, 47 
XPL, 48 
PROCEED (green) light, 76 
Processor, 439 
Prograa, 439 
Program control coamands, 39 
Program interrupt, 167, 211, 324, 
371, 373, 440 
Program interrupt code, 371 
Program mask, 241 
Program returns, 323 
Program segment, 440 
Program status word, 480 
Project, 440 
Projectaccount prototypes 
mary, 398 
Project accounting, 383 
Project key, %40 
PROJECT parameter, 389 
Prompting command mode, 168 
Protection exception, 371 
PROUTE CONTROL command parameter, 
191 
PROUTE option, 90 
PROUTE parameter, 98, 179, 257 
Pseudo-device, 440 
Pseudo-device nase, 
109, 240, 440 
Pseudo-device name defaults, 98 


suse 


27, 36, 89, 
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PSW, 241, 333, 377, 440 

PSW DISPLAY command paraneter, 
208 

PTR device type, 143 

PTTc, 440 

Public file, 30, 108, %41 

Public file name, 109 

Public library file, 441 

Punch, 441 

Punch card, 36, 461 

PUNCH INQUIRE command paraseter, 
177, 217 

Punch phase, 103 

Punch queue, 103 

Punched output, 101, 441 

Punched output retarn codes, 160 

Perge phase, 103 

PUSH CONTROL command parareter, 
189 

PW parameter, 17, 178, 179, 251, 
256 


Q (qualify), 333, 357 

Q aodifier, 317 

QN, 98 

QUALIFY debug command, 333, 357 

QUE INQUIRE command parameter, 
177, 217 

Queue, 103, 441 

execution, 103 

print, 103 

punch, 103 

HOUNT keyword parareter, 

233, 234 

(replace), 269, 27%, 295 

(restore), 333, 359 

(route), 90 

(run), 243 

modifier, 310, 317 

Rack nursber, 441 

Randorg access, 441 

Raw data, 441 

RC, 461 

RCALL subroutine, 372 

RE (restart), 241 

Re-entrant, 443 

Re-usable, 4&4 

Read, 441 

Read Pointer, 153 

READ subroutine, 121, 228, 244 

Read-only storage, 442 

Read~-only-file, 210, 212 

Read-write head, 442 

Reader, 441 


Quit 
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READY (blue) light, 76 
Real address, 442 
Real memory, 442 
Real tine, 442 
Real variable, 442 
Relative address, 44 
Receipt card, 442 
Receipt number, 89, 101, 176, 185 
Receive mode, 78 
RECFM control command paraneter, 
RECFM MOUNT keyword parameter, 
233 
Record, 156, 442 
density, 442 
format, 442 
gap, 842 | 
index, 442 
length, 443 
Red-topped lever, 75 
REDUCE, 49, 49 
Reel, 443 
Reference centers, 10 
REG (region), 269, 274, 293 
Region, 266 


RFGION edit command, 43, 272, 
274, 293 

Region names, 272 

Register, 443 

REL (release), 90, 240 

Relative address, 309 

Relative addressing, 443 

RELEASE command, 20, 41, 171, 
178, 240 

RELFASE CONTROL command paramet- 
er, 191 


RELEPASE option, 90 

Relocation factor, 175, 313, 375 
global, 175, 218, 241, 251 
local, 175, 203, 241 

Renote batch, 102 

Rerote batch sode, 443 

Remote batch station, 35, 97 

Reaote Job Entry, 35 

Remote terminal, 443 

REMOTES INQUIRE command paramet- 
er, 177, 218 

REN (renumber), 269, 274, 298 


RENUMBER edit command, 44, 2754, 
294 

REPLACE edit command, 43, 55, 56, 
274, 295 


Reproducing punch, 4&3 
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REPT key, 75 

RERUN MOUNT keyword parameter, 
233 

RES (restore), 269, 274, 296 

RESE (reset), 333, 358 

RESET CONTROL command paraneter, 
190 

RESET debug command, 46, 333, 358 

RESET device command, 86 

Resident system, 443 

Resolve external symbol resolu- 
tion, 444 

Resolve library references, 444 

Response time, 444 

Restart, 445 


RESTART command, 39, 166, 178, 
175, 178, 241 

RESTORE debug command, 45, 70, 
333, 359 

RESTORE edit command, 44, 1384, 


267, 274, 296 

RETRY CONTROL command paraseter, 

189 

MOUNT keyword parameter, 

233 

RETURN, 80, 94, 96 

Return code, 375, 444 

RETURN key, 75, 76 

RETURNLINE# modifier, 148 

REV CONTROL command parameter, 
190 

REW CONTROL command 
188 

Rewind, 444 

REWIND subroutine, 121 

RF, 213, 214 

RF debug command, 332, 333, 333 

RF DISPLAY command parameter, 203 

RF parameter, 179, 180, 241 

RF SET command keyword parameter, 
251 

RF SET debug command paraaeter, 
365 


RETRY 


parameter, 


Right justify, 444 

Ring, 444 

RING MOUNT keyword parameter, 233 

RJE, 35 

RMNAR CONTROL command parangeter, 
190 

RMAR device command, 83 

RMTS INQUIRE command parareter, 
177, 218 

RO PERMIT accessetype, 138, 238 
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Round-off error, 444 

ROUTE CONTROL command paranseter, 
191 

ROUTE option, 90 

ROUTE parameter, 98, 179, 257 

Routine, 444 

RPW MOUNT keyword paraseter, 233 

RSTIME subroutine, 375 

RU (RUN), 333, 360 

RUBOUT key, 75 


RUBOUT, 94 

RON command, 20, 39, 166, 174, 
178, 243 

RUN debug command, 45, 66, 167, 
324, 360 


RUN PERMIT access-type, 138, 238 

Run time, 444 

S (scan), 269, 274, 297 

(seconds), 228, 244, 256 

(set), 248 

(short), 179, 203, 206, 255 

(success), 268 

(syabol), 333, 368 

INQUIRE command parameter, 177, 

220 

S modifier, 143 

S type code, 316, 316 

S-8 card, 4489 

SAME INQUIRE command paraaeter, 
177, 216 

Save area, 444 

SC (SCAN), 333, 361 

SCA (SCALE), 333 


NNANNAN 


’ SCALE debug command, 333 


SCALE SET debug command paramete 


er, 365 

SCAN debug command, 46, 318, 333, 
361 

SCAN edit command, 42, 54, 60, 


270, 271, 274, 297 
SCARDS, 26, 198, 445 
SCARDS subroutine, 228, 244 
Scratch file, 108, 445 
SCRFCHAR parameter, 109, 179, 252 
SD (sds), 247, 333, 362 
SDA device type, 143 
SDS, 45, 64, 167, 307, 445 
SDS command, 40, 178, 247 
SDS constants, 3138 
SDS debug command, 45, 333, 362 
SDS parameters, 309 
SDS simulator, 326 
SE (set), 269, 274, 298, 333, 363 
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Seguents, 37 
Selectric Typewriter 
33, 35, 73, 95 
Self-contained prograa, 445 
Sense bytes, 445 
Separator, 445 
SEQ, 122, 196 
SEQFCHK parameter, 126, 129, 144, 
179, 252 
SEQFCHK switch, 179 
Sequential, 122 
Sequential file, 
956, 196, 445 
Sequential file check, 252 
Sequential file with line 
bers, 127, 196 
Sequential operation, 123 
Sequential with line number file, 
122, 196 
SEQUL, 122, 127, 196 
SERCOM, 198, 485 
SERCOM subroutine, 228, 24% 
Serially re-usable, 445 
Service files, 51 
SET command, 39, 
178, 248, 375 
SET debag command, 46, 308, 
63 
SET debug command parargeters 
ATPREPIX, 363 
ATTN, 363 
BLANK, 363 
ENTRY, 363 
ERRORDUMP, 363 
INDCH, 363 
INPUT, 363 
LEW, 36% 
MODCH, 368 
OMAPCH, 365 
OUTPUT, 364 
PAR, 364 
PGHT, 368 
PREFIX, 365 
RF, 365 
SCALE, 365 
TERSE, 365 
TYPE, 365 
XFR, 365 
SET edit comsand, 43, 266, 274, 
298 
SETAFD subroutine, 121 
SETIME subroutine, 375 
SETIOERR subroutine, 158, 375 
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122, 125, 153, 


hnua- 


99, 174, 175, 
333, 
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SETPFX subroutine, 39 

Setting and clearing Breakpoints, 
45 

Seven-track magnetic tape, 445 

Seven-track magnetic tape drive, 
445 


Severity code, 446 

SGLS parameter, 202, 206 

SH (shift), 269, 274, 300 

Share file character, 252 

Shared files, 138 

SHFSEP parareter, 179, 252 

SHIFT edit command, 43, 274, 300 

SHIFT key, 78 

SHORT, 255 

SI (sink), 259 

SIG (signoff), 255 

SIG (signon), 256 

SIGFILE DISPLAY command paramet=- 
er, 204 

SIGFILE parameter, 179, 252 

SIGFILEATTN parameter, 179, 252 

SIGNHSG INQUIRE command paraaseter, 
220 

Significance exception, 371 

SIGNOFF $, 179, 255 @ 

SIGNOFF command, 16, 39, 179, 255 

SIGNOFF short, 255 

Signoff statistics, 101, 255 

SIGNON command, 16, 39, 179, 256 

Signon id, 77, 383 

SIMSCRIPT-II, 50 

Simulation languages, 49 
CSMP, 49 
GPSS, 590 
SIMSCRIPT-II, 50 

Single precision, 446 

SINK command, 39, 179, 259 

SIOERR subroutine, 375 | 

SIZE CREATE command parameter, 
196 

SIZE MOUNT keyword parameter, 234 

SIZE parameter, 128, 176 

SIZE CONTROL command parameter, 
188 

SKIP subroutine, 121 

SLIP, 49 

SNAP, 49 

Snark, 446 

SNOBOL, 446 

SHOBOLS, 49 

SO (source), 260 

Software, 486 — 
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SOH, 94 

Sorter, 446 

SOURCE command, 39, 179, 260 

Source deck, 446 

Source language, 447 

Source program, 18, 4&7 

SP modifier, 151 

Special character, 447 

Specification exception, 371 

SPIE macro, 372 

SPIE subroutine, 372 

SPL, 47 

SPOOLING, 447 

SPRINT, 26, 198, 447 

SPRINT subroutine, 228, 244 

SPSS, 50 

SPUNCH, 26, 198, 447 

SPUNCH subroutine, 228, 244 

SP1 parameter, 202, 206 

SP2 parameter, 202, 206 

SS aodifier, 146 

SSPC parameter, 202, 206 

ST (start), 261 

ST (step), 333, 366 

ST (stop), 269, 274, 301 

STA (status), 398, 400 

Stacker, 447 

START command, 39, 166, 17%, 175, 
179, 261 

Starting line number, 236 

Station, 447 

Statistical Program Packages, 50 
CONSTAT, 50 
OSIRIS, 50 
SPSS, 50 

Statistics at signoff, 92, 101, 
255 

STATUS INQUIRE command parazeter, 
177, 221 

STATUS projectaccount command, 
386, 398, 400 

STEP debug command, 45, 167, 326, 
333, 366 

STO (stop), 333, 367 

STOP debug command, 45, 167, 333, 
367 

STOP edit command, 43, 167, 
301 

STOP network command, 167 

Storage, 447 

Storage duap, 250 

Storage location, 4&7 

Storage protection, 447 
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Store, 448 
STRANDS INQUIRE command paraset= 
er, 177, 221 
String processing languages, 49 
Strings, 271, 448 
SUB (subtract), 398, 400 
Sub-prograa, 448 
Submitting batch job, 35 
Subroutine, 448 
Subroutine library, 228, 244 
SUBTRACT projectaccount command, 
384, 398, 400 
SUCCESS, 268 
Summary 
debug command prototypes, 
333 
edit command prototypes, 274 
MTS command prototypes, 175 
PROJECTACCOUNT prototypes, 
398 
statistics at the 
job, 101, 255 
Supervisor, 448 
call, 448 
interrupt, 448 
program, 448 
state, 448 
task number, 449 
Switches, 266 
SYMBOL debug command, 46, 
368 
Symbol modifier, 317 
Symbol table, 63, 252, 449 
Symbolic address, 311 
Symbolic Debugging Systen, 44, 
63, 211, 307, 449 
Symbolic languange, 449 
Syabolic referencing, 309 
SYMTAB parameter, 179, 252 
SYMTAB switch, 179 
System, 449 
Command Language, 23, 38, 
165 


end of 


333, 


interrupt, 449 
library, 489 
load, 104 
subroutine 
228, 244 

SYSTEM debug command, 323 

SYSTEM subroutine, 166 

T (terse), 333 

T (time), 228, 244, 256 

fT (tracks), 196 


library, 228, 
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T (trim), 299 

T device-type INQUIRE 
parameter, 177, 219 

TAB CONTROL command parargeter, 
191 

TAB key, 76 

Tab setting, 32 

Tab stop, 76 

TABI CONTROL command parasgeter, 
190 

TABI device comaand, 84 

TABO CONTROL command parameter, 
190 

TABO device command, 84 

Tailesheet, 101 

Tape, 449 

TAPES INQUIRE command paraseter, 
177, 219 

TAPES parameter, 177 

Task number, 449 

TDR parameter, 179, 252 

Technical Mesos, 9 

Telephone nuabers 
information, 77, 93, 9§ 
terminal, 76, 93, 95 

Teletype, 35, 74, 92 
Model 33, 73 
Model 35, 73 

Temporary file, 108, 201, 449 

TERMHRS parameter, 391, 398, 400 

Terminal, 99, 450 

Terminal job, 450 

Terminal mode, 15, 98, 450 

TERMINAL parameter, 390, 398 

TERSE CONTROL command parameter, 
190 

TERSE debug command, 333 

fTerse node, 329 

TERSE parameter, 179, 253 

TERSE SET debug command paranet- 
er, 365 — 

TEST parameter, 309 

TEXT360, 52 

TICALL subroutine, 375 

Time limit, 98, 374 

Time paraneter, 17, 98, 178, 179, 

228, 244, 256 

Time slice, 450 

Tise-sharing, 450. 

Timer interrupt, 328, 374 

TIMNTRP subroutine, 375 | 

TN, 90, 98 

TO,. 176, 193 
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Track, 128, 450 

Track index, 156 

Translator, 450 

Transmission Control unit, 87 

Transmission rate, 73, 74, 93 

Transmit mode, 78, 92 

Trap, 450 

TRIM modifier, 141, 150, 253, 265 

TRIM parameter, 179, 253, 299 

Truncate, 450 

Truncation error, 450 

TSS, 450 

TTY device type, 143 

TWAIT subroutine, 375 

TY (TYPE), 333 

Type code, 316 

TYPE CREATE command paraseter, 
196 

TYPE debug command, 333 

TYPE modifier, 316, 319 

TYPE parameter, 129, 176 

TYPE SET debug command parameter, 
365 

UO (unnuaber), 263 

U (using), 333, 369 

U signon-id INCUIRE command para- 
meter, 177, 220 

uc, 178, 248 

UC CONTROL command parameter, 191 

uc modifier, 142, 145 

ucI CONTROL command parameter, 
190 

UCO CONTROL command parameter, 
190 

UMIST, 49, 451 

UNDERFLOW, 373 

Underlining, 175, 273, 332 

Unit, 451 

UNL (unload), 262 

Unload, 451 

UNLOAD command, 39, 179, 262 

UNLOAD parameter, 179, 253 

UNLOAD switch, 179, 253 

UNNUMBER command, 22, 41, 179, 
263 

Update, 451 

Updating a file, 53, 162 

Updating file defensively, 162 

Upper case, 84, 175, 273, 332 

User, 451 

User file, 451 

USERS INQUIRE command parameter, 
177, 221 
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Users password, 100, 251 

USING debug command, 46, 
333, 369 

Utility progran, 451 

V (verify), 299 

Vv modifier, 270 

V type code, 316 

Variable, 451 

Verification modifier, 

VERIFY parameter, 299 

Vertical redundancy table, 451 

Virtual address, 309, 451 

Virtual memory, 37, 451 

VMNSIZE DISPLAY command parameter, 
2c4a 

VOL MOUNT keyword parameter, 234 


315, 


270 


VOLSER MOUNT keyword parameter, 
234 

Volume, 452 

VOLUME MOUNT keyword parameter, 
234 

W type code, 316 

Wait, 452 

WARN CONTROL comaand parameter, 
190 


WARN device command, 86 

Wastebasket, 111 

WATPOR, 18, 47, 4&52 

WATFOR Library, 452 

Westinghouse 1600 Cathode 
Terminal, 35, 73, 92, 95 

Word, 452 

WPW MOUNT keyword parameter, 234 


Ray 


WRITE MOUNT keyword parameter, 
234 

Write Pointer, 153 

WRITE subroutine, 121, 228, 244 


WRU, 94 
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WSU Introductory Publications, 11 

WSO MTS manuals, 10 

WIM CONTROL command parameter, 
189 

X¥ (hex), 299 

X (xec), 269, 274, 302 

X modifier, 270, 311, 317 

X type code, 316 

X°ON, 96 

XCTL debug command, 324 

XCTL SUBROUTINE, 167, 241 

XEC edit command, 43, 274, 302 

Xec names, 272 

Xec procedure, 267 

Xec switches, 266, 
ENDOFFILE, 268 
FAILURE, 268 
SUCCESS, 268 


268 


XFR SET debug command parameter, 
365 
XPL, 48 


XREF parameter, 177, 178, 
198, 227, 241, 243, 261 

Y type code, 316 

Z type code, 316 

ZERODIVIDE, 373 

1050 terminal, 35 

12-edge, 452 

1403 printer, 99 

2318 Disk Drive, 156 

2741 Communication Terminal, 35 

360-asseabler language, 404 

Jetrack magnetic tape, 452 

9-edge, 452 

9=-track magnetic tape, 452 

9TP device type, 143 

9TP MOUNT device-type, 231 
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